IMsgServiceAdmin::DeleteMsgService
適用対象: Outlook 2013 | Outlook 2016
プロファイルからメッセージ サービスを削除します。
HRESULT DeleteMsgService(
LPMAPIUID lpuid
);
パラメーター
lpuid
[in]削除するメッセージ サービスの一意識別子を含む MAPIUID 構造体へのポインター。
戻り値
S_OK
メッセージ サービスが削除されました。
MAPI_E_NOT_FOUND
lpuid が指す MAPIUID は、既存のメッセージ サービスと一致しません。
注釈
IMsgServiceAdmin::D eleteMsgService メソッドは、プロファイルからメッセージ サービスを削除します。 DeleteMsgService は、 メッセージ サービスに関連するすべてのプロファイル セクションを削除します。
DeleteMsgService は、次の手順を実行してメッセージ サービスを削除します。
プロファイル セクションが削除される前に ulContext パラメーターを MSG_SERVICE_DELETE に設定して、メッセージ サービスのエントリ ポイント関数を呼び出します。 これにより、サービスはサービス固有のタスクを実行できます。
メッセージ サービスを削除します。
メッセージ サービスのプロファイル セクションを削除します。
メッセージ サービスのエントリ ポイント関数は、サービスが削除された後に再び呼び出されません。
呼び出し側への注意
削除するメッセージ サービスの MAPIUID 構造体を取得するには、メッセージ サービス テーブル内のメッセージ サービスの行から PR_SERVICE_UID (PidTagServiceUid) プロパティ列を取得します。 詳細については、 IMsgServiceAdmin::CreateMsgService メソッドで説明されている手順を参照してください。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MsgServiceTableDlg.cpp |
CMsgServiceTableDlg::OnDeleteSelectedItem |
MFCMAPI では、 IMsgServiceAdmin::D eleteMsgService メソッドを使用して、選択したサービスを削除します。 |