POP3_UIDToNum

version 6.5

POP3_UIDToNum (pop3_ID; uniqueID; msgNumber) --> 整数

POP3_UIDToNum コマンドはメッセージのユニークIDを、pop3_IDで指定されるメールボックス中のメッセージリストの、現在のmsgNumberに変換します。特定のメールメッセージのmsgNumber、メールリスト中の他のメッセージと相対的です。このコマンドは現在のメッセージの位置情報を返します。

pop3_ID はPOP3_Loginで作成される、開かれたセッションの参照です。

uniqueID はPOP3サーバ上のメッセージを特定するために使用するユニークIDです。このコマンドは、pop3_IDで参照されるアカウントのメッセージヘッダからこの値を探します。見つかると、メッセージの現在の位置がmsgNumberに返されます。

msgNumber には、uniqueIDで指定された項目の現在のメッセージ番号が返されます。サーバ上でuniqueIDが見つからない場合、msgNumberに0が返され、エラーは生成されません。