IMsgServiceAdmin::DeleteMsgServiceIMsgServiceAdmin::DeleteMsgService

適用されます: OutlookApplies to: Outlook

メッセージ サービスをプロファイルから削除します。Deletes a message service from a profile.

HRESULT DeleteMsgService(
  LPMAPIUID lpuid
);

ParametersParameters

lpuidlpuid

[in]削除するメッセージ サービスの一意の識別子を格納するMAPIUID構造体へのポインター。[in] A pointer to the MAPIUID structure that contains the unique identifier for the message service to delete.

�߂�lReturn value

S_OKS_OK

メッセージ サービスが削除されました。The message service was deleted.

MAPI_E_NOT_FOUNDMAPI_E_NOT_FOUND

_Lpuid_で指定されたMAPIUIDでは、既存のメッセージ サービスが一致しません。The MAPIUID pointed to by lpuid does not match an existing message service.

備考Remarks

IMsgServiceAdmin::DeleteMsgServiceメソッドは、メッセージ サービスをプロファイルから削除します。The IMsgServiceAdmin::DeleteMsgService method deletes a message service from a profile. DeleteMsgServiceは、メッセージ サービスに関連するすべてのプロファイル セクションを削除します。DeleteMsgService removes all profile sections related to the message service.

DeleteMsgServiceは、メッセージ サービスを削除するのには次の手順を実行します。DeleteMsgService performs the following steps to delete the message service:

  1. プロファイルのセクションを削除する前に MSG_SERVICE_DELETE を設定する_ulContext_パラメーターを使用して、メッセージ サービスのエントリ ポイント関数を呼び出します。Calls the message service's entry point function with the ulContext parameter set to MSG_SERVICE_DELETE before the profile sections are removed. これにより、サービスに固有のタスクを実行するサービスです。This allows the service to perform any service-specific tasks.

  2. メッセージ サービスを削除します。Deletes the message service.

  3. メッセージ サービスのプロファイル セクションを削除します。Deletes the message service's profile section.

サービスが削除された後、メッセージ サービスのエントリ ポイント関数は再び呼び出されません。The message service's entry point function is not called again after the service has been deleted.

呼び出し側への注意Notes to callers

メッセージ サービスを削除するのには、 MAPIUID構造体を取得するには、メッセージ サービスのテーブルの行のメッセージ サービスからPR_SERVICE_UID (PidTagServiceUid) のプロパティの列を取得します。To retrieve the MAPIUID structure for the message service to delete, retrieve the PR_SERVICE_UID (PidTagServiceUid) property column from the message service's row in the message service table. 詳細については、 IMsgServiceAdmin::CreateMsgServiceメソッドで説明する手順を参照してください。For more information, see the procedure outlined in the IMsgServiceAdmin::CreateMsgService method.

MFCMAPI 参照MFCMAPI reference

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

�t�@�C��File �֐�Function �R�����gComment
MsgServiceTableDlg.cppMsgServiceTableDlg.cpp
CMsgServiceTableDlg::OnDeleteSelectedItemCMsgServiceTableDlg::OnDeleteSelectedItem
MFCMAPI では、 IMsgServiceAdmin::DeleteMsgServiceメソッドを使用して、選択したサービスを削除します。MFCMAPI uses the IMsgServiceAdmin::DeleteMsgService method to delete the selected service.

関連項目See also

MAPIUIDMAPIUID

IMsgServiceAdmin: IUnknownIMsgServiceAdmin : IUnknown

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