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 を呼び出してフォーム ビューアーにメッセージを設定します。 最後に、フォーム ビューアーをメッセージ サイトとして返します。

関連項目

IMAPIViewContext : IUnknown

IMAPIMessageSite : IUnknown

[�R��h �T���v���Ƃ��� MFCMAPI

MAPI フォーム インターフェイス