4D Internet Commands v14

IMAP_MsgLstInfo

ホーム

 
4D Internet Commands v14
IMAP_MsgLstInfo

IMAP_MsgLstInfo 


 

IMAP_MsgLstInfo ( imap_ID ; startMsg ; endMsg ; msgSizeArray ; msgNumArray ; msgIdArray ) -> 戻り値 
引数   説明
imap_ID  倍長整数 in IMAPログイン参照
startMsg  倍長整数 in 開始メッセージ番号
endMsg  倍長整数 in 終了メッセージ番号
msgSizeArray  倍長整数配列 in サイズ配列
msgNumArray  倍長整数配列 in メッセージ番号配列
msgIdArray  倍長整数配列 in ユニークメッセージID配列
戻り値  整数 in エラーコード

説明   

IMAP_MsgLstInfo コマンドは (IMAP_SetCurrentMB コマンドで指定された) 現在処理対象のメールボックスの、一連のメッセージに関する情報を返します。情報は三つの配列に返され、配列のそれぞれの要素は一つのメッセージに対応します。メッセージサイズや番号に関する情報が返されます。配列は事前に定義されていなければなりません。IMAP_MsgLstInfo コマンドはそれぞれの配列サイズをメッセージ数にリセットします。

IMAP_MsgLstInfo コマンドは、カレントのメッセージリスト中のメッセージの取得に失敗しても、エラーは返しません。エラーが発生すると、そのメッセージの配列要素は作成されません。コマンドがメッセージを読み込むと、msgNumArrayには順番に数値が格納されます。問題があった場合には、msgNumArray配列に格納された数値に抜けが生じます。

imap_IDIMAP_Loginで作成されるIMAPログイン参照です。

startMsg は情報を取得するメッセージリストの開始メッセージ番号です。メッセージ番号は現在処理対象のメールボックス中のすべてのメッセージにおける、メッセージの位置を表します。

endMsg は情報を取得するメッセージリストの終了メッセージ番号です。メッセージ番号は現在処理対象のメールボックス中のすべてのメッセージにおける、メッセージの位置を表します。

Note: IMAP_Delete, IMAP_MsgLstInfo, IMAP_MsgLst, IMAP_SetFlags, IMAP_GetFlags そしてIMAP_CopyToMBコマンドは、startMsgendMsgよりも大きい場合でもエラーを返しません。この場合、コマンドは何も行いません。

sizeArray は、startMsgからendMsgまでのそれぞれのメッセージサイズを受け取る倍長整数配列です。

msgNumArray は、startMsgからendMsgまでのそれぞれのメッセージ番号を受け取る倍長整数配列です。

msgIdArray は、startMsgからendMsgまでのそれぞれのメッセージユニークIDを受け取る倍長整数配列です。

 
プロパティ 

プロダクト: 4D Internet Commands
テーマ: IC IMAP メール閲覧
番号: 88872

 
履歴 

初出: 4D Internet Commands 6.8.1

 
参照 

IMAP_SetCurrentMB

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v11.4)
4D Internet Commands ( 4D v13.2)
4D Internet Commands ( 4D Internet Commands v12.1)
4D Internet Commands ( 4D Internet Commands v14 R2)
4D Internet Commands ( 4D Internet Commands v14)
4D Internet Commands ( 4D Internet Commands v14 R3)
4D Internet Commands ( 4D Internet Commands v14 R4)