メッセージの受信元のフォルダを変更します。   

構文

&DataType.ChangeFolder( [ FolderName ] )
戻されるタイプ:
Numeric

入力値の説明:
FolderName
   電子メールの読み込み元のフォルダの名前です。これはオプションのパラメーターです。指定しなかった場合や空白にした場合は、Inbox フォルダを参照します。

適用範囲

拡張データタイプ: MAPISession、OutlookSession

ジェネレーター: Java、Ruby (GeneXus X Evolution 3 まで)、Visual FoxPro (GeneXus X Evolution 3 まで)

説明

フォルダ名の正しい定義に関するルール:
フォルダ名の表記方法は、DOS や UNIX でディレクトリーのナビゲーションに使用されるものと似ていますが、いくつか例外があります。通常、次のルールに従います:

• 文字「.」は、現在のフォルダを示すのに使用します。  
• 「..」という文字列は、上位のフォルダを示すのに使用します。  
• 文字「\」は、サブフォルダを示すのに使用します。  
• 名前の最初に文字「\」を使用すると、ルートを示すことができます。  

「\」や「..」を使用せずに単純な名前を指定した場合は、Inbox フォルダと同じレベルのフォルダが参照されます。「*Inbox」、「*Outbox」、「*Sent Items」、「*Deleted Items」、「*Drafts」という値は、正確な名前ではなく、通常そのような名前で呼ばれているフォルダを示すのに使用します。これは、クライアントがほかの言語で使用されている場合に役立ちます。たとえば、スペイン語版の Outlook の場合は、スペイン語の名前に関係なく、「*Inbox」は Inbox フォルダを指します。
たとえば、次のような構造があるとします:
Mailbox
                Drafts
                Inbox
                           Urgent  
                Outbox
                Pending
                           On Hold
                Sent Items
Public Folders
                Favorites
                All Public Folders
                           General

FolderName で有効な値は次のとおりです: 

• “Pending”
• “Pending\On Hold”
• “\Mailbox\Pending”
•  “\Public Folders\All Public Folders\General”
• “*Inbox\Urgent”

現在選択されているフォルダが Inbox\Urgent の場合:

• “..”(Inbox フォルダを選択)
• “..\..\Pending\On Hold”

現在選択されているフォルダが Inbox の場合:

• “.\Urgent”

参考情報

Receive メソッド
Send メソッド
MAPISession データタイプ
OutlookSession データタイプ