IMAPIMessageSite::NewMessage
適用対象: Outlook 2013 | Outlook 2016
新しいメッセージを作成します。
HRESULT NewMessage(
ULONG fComposeInFolder,
LPMAPIFOLDER pFolderFocus,
LPPERSISTMESSAGE pPersistMessage,
LPMESSAGE FAR * ppMessage,
LPMAPIMESSAGESITE FAR * ppMessageSite,
LPMAPIVIEWCONTEXT FAR * ppViewContext
);
パラメーター
fComposeInFolder
[in]メッセージを構成するフォルダーを示します。 変数が FALSE の場合、 pFolderFocus パラメーターは無視され、フォーム ビューアーは任意のフォルダーでメッセージを作成できます。 変数が TRUE で、 pFolderFocus パラメーターに NULL が渡された場合、メッセージは現在のフォルダーで構成されます。 変数が TRUE で、null 以外の値が pFolderFocus で渡される場合、メッセージは pFolderFocus が指すフォルダーで構成されます。
pFolderFocus
[in]新しいメッセージが作成されるフォルダーへのポインター。
pPersistMessage
[in]新しいフォームのフォーム オブジェクトへのポインター。
ppMessage
[out]新しいメッセージへのポインターへのポインター。
ppMessageSite
[out]新しいメッセージのメッセージ サイト オブジェクトへのポインターへのポインター。
ppViewContext
[out]新しいメッセージを含む新しいフォームへの渡しに適したビュー コンテキストへのポインターへのポインター。 フォームが独自のビュー コンテキストを実装している場合は、 ppViewContext パラメーターで NULL を渡すことができます。
戻り値
S_OK
�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��B
注釈
フォーム オブジェクトは IMAPIMessageSite::NewMessage メソッドを呼び出して、新しいメッセージを作成します。 フォームでは 、NewMessage を 使用して、ビューから新しいメッセージと関連するメッセージ サイトを取得します。 その後、新しいメッセージを変更できます。
関連するビュー コンテキストを取得するには、 ppViewContext パラメーターに NULL 以外の値を渡します。 このビュー コンテキストは直接使用することも、集計して新しいメッセージに渡すこともできます。 完全な実装が必要な場合は、 ppViewContext で NULL を渡します。
フォーム サーバーに関連するインターフェイスの一覧については、「 MAPI フォーム インターフェイス」を参照してください。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::NewMessage |
MFCMAPI では 、IMAPIMessageSite::NewMessage メソッドを使用して新しいメッセージを作成し、新しいフォーム ビューアーをインスタンス化し、 SetPersist を呼び出してフォーム ビューアーにメッセージを設定します。 最後に、フォーム ビューアーをメッセージ サイトとして返します。 |