4D Doc Center : IMAP

4D Internet Commands v14

IMAP_RenameMB


IMAP_RenameMB ( imap_ID ; mbName ; newMBName ) -> 戻り値

引数	型	説明
imap_ID	倍長整数	IMAPログイン参照
mbName	テキスト	名称を変更するメールボックス名
newMBName	テキスト	新しいメールボックス名
戻り値	整数	エラーコード

説明

IMAP_RenameMB コマンドはメールボックスの名称を変更します。存在しないメールボックスの名称を変更しようとしたり、既存のメールボックス名と同じ名称に変更しようとしたりすると、エラーが生成されます。

Note: INBOXの名称変更は許可されていますが、この場合特別な動作をします。これを行うと、指定された名称の新しいメールボックスが作成され、INBOX内のすべてのメッセージがそのメールボックスに移動されます。INBOXは空になります。サーバの実装がINBOXの子メールボックスを許可している場合、名称変更によるこれらのメールボックスへの影響はありません。

imap_ID はIMAP_Loginで作成されるIMAPログイン参照です。

mbName は名称を変更するメールボックス名です (IMAPの命名規則を参照してください).

newMBName は mbNameメールボックスに適用する新しいメールボックスの完全名です。