IMAPIMessageSite::GetMessageIMAPIMessageSite::GetMessage

適用されます: OutlookApplies to: Outlook

現在のメッセージを返します。Returns the current message.

HRESULT GetMessage(
  LPMESSAGE FAR * ppmsg
);

ParametersParameters

ppmsgppmsg

[out]メッセージの返されるインターフェイスへのポインターへのポインター。[out] A pointer to a pointer to the returned interface for the message.

�߂�lReturn value

S_OKS_OK

�ʘb���������A�\�������l�܂��͒l���Ԃ���܂��BThe call succeeded and has returned the expected value or values.

S_FALSES_FALSE

メッセージ現在存在しない呼び出し元のフォームにします。No message currently exists for the calling form.

備考Remarks

フォームでは、現在のメッセージのメッセージのインターフェイスを取得するIMAPIMessageSite::GetMessageメソッドを呼び出します。Forms call the IMAPIMessageSite::GetMessage method to obtain a message interface for the current message. 現在のメッセージは、 IPersistMessage::InitNewIPersistMessage::Load、またはIPersistMessage::SaveCompletedメソッドに渡されたものでは以前と同じメッセージ。The current message is the same message as was previously passed in the IPersistMessage::InitNew, IPersistMessage::Load, or IPersistMessage::SaveCompleted method.

メッセージ現在存在しない場合は、自動インクリメントは S_FALSE を返します。GetMessage returns S_FALSE if no message currently exists. IPersistMessage::HandsOffMessageメソッド、またはIPersistMessage::Loadの次の呼び出しの前に、の呼び出しの後に発生することがこの状態や、 IPersistMessage::SaveCompletedが行われます。This state can occur after calls to the IPersistMessage::HandsOffMessage method or before the next call to IPersistMessage::Load or IPersistMessage::SaveCompleted is made.

フォームのサーバーに関連するインターフェイスの一覧は、 MAPI フォームのインタ フェースを参照してください。For a list of interfaces related to form servers, see MAPI Form Interfaces.

MFCMAPI 参照MFCMAPI reference

MFCMAPI �T���v�� �R�[�h�ł́A���̕\��Q�Ƃ��Ă��������BFor MFCMAPI sample code, see the following table.

�t�@�C��File �֐�Function �R�����gComment
MyMAPIFormViewer.cppMyMAPIFormViewer.cpp
CMyMAPIFormViewer::GetSessionCMyMAPIFormViewer::GetSession
MFCMAPI メソッドを使用して、 IMAPIMessageSite::GetMessage 、現在キャッシュされているメッセージ ポインターを返すことがある場合。MFCMAPI uses the IMAPIMessageSite::GetMessage method to return the currently cached message pointer, if it is available.

関連項目See also

IPersistMessage::HandsOffMessageIPersistMessage::HandsOffMessage

IPersistMessage::InitNewIPersistMessage::InitNew

IPersistMessage: IUnknownIPersistMessage : IUnknown

IPersistMessage::LoadIPersistMessage::Load

IPersistMessage::SaveCompletedIPersistMessage::SaveCompleted

IMAPIMessageSite: IUnknownIMAPIMessageSite : IUnknown

[�R��h �T���v���Ƃ��� MFCMAPIMFCMAPI as a Code Sample

MAPI フォームのインタ フェースMAPI Form Interfaces