IMsgStore::SetReceiveFolder
適用対象: Outlook 2013 | Outlook 2016
特定のメッセージ クラスの受信メッセージの宛先としてフォルダーを確立します。
HRESULT SetReceiveFolder(
LPSTR lpszMessageClass,
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
パラメーター
lpszMessageClass
[in]新しい受信フォルダーに関連付けるメッセージ クラスへのポインター。 lpszMessageClass パラメーターが NULL または空の文字列に設定されている場合、SetReceiveFolder はメッセージ ストアの既定の受信フォルダーを設定します。
ulFlags
[in]渡された文字列内のテキストの型を制御するフラグのビットマスク。 次のフラグを設定できます。
MAPI_UNICODE
メッセージ クラスの文字列は Unicode 形式です。 MAPI_UNICODE フラグが設定されていない場合、メッセージ クラス文字列は ANSI 形式です。
cbEntryID
[in] lpEntryID パラメーターによって指されるエントリ識別子のバイト数。
lpEntryID
[in]受信フォルダーとして確立するフォルダーのエントリ識別子へのポインター。 lpEntryID パラメーターが NULL に設定されている場合、SetReceiveFolder は現在の受信フォルダーをメッセージ ストアの既定値に置き換えます。
戻り値
S_OK
受信フォルダーが正常に確立されました。
注釈
IMsgStore::SetReceiveFolder メソッドは、特定のメッセージ クラスの受信フォルダーを設定または変更します。 SetReceiveFolder を使用すると、クライアントは、連続する呼び出しを使用して、定義されたメッセージ クラスごとに異なる受信フォルダーを指定したり、複数のメッセージ クラスの受信メッセージがすべて同じフォルダーに移動するように指定したりできます。 たとえば、クライアントは独自のメッセージ クラスを独自のフォルダーに到着させることができます。 FAX アプリケーションは、ストア プロバイダーが受信 FAX を配置する 1 つのフォルダーと、プロバイダーが送信 FAX を配置する別のフォルダーを指定できます。
SetReceiveFolder の呼び出し中にエラーが発生した場合、受信フォルダーの設定は変更されません。
SetReceiveFolder が lpEntryID を NULL に設定して受信フォルダーの設定を変更した場合、既定の受信フォルダーを設定する必要があることを示す SetReceiveFolder は、指定されたメッセージ クラスの既存の設定がない場合でも、S_OKを返します。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MsgStoreDlg.cpp |
CMsgStoreDlg::OnSetReceiveFolder |
MFCMAPI では 、IMsgStore::SetReceiveFolder メソッドを使用して、特定のメッセージ クラスの受信フォルダーとしてフォルダーを設定します。 |