IProviderAdmin::DeleteProvider

適用対象: Outlook 2013 | Outlook 2016

メッセージ サービスからサービス プロバイダーを削除します。

HRESULT DeleteProvider(
  LPMAPIUID lpUID
);

パラメーター

lpUID

[in, out]削除するプロバイダーを表す一意の識別子を含む MAPIUID 構造体へのポインター。

戻り値

S_OK

プロバイダーがメッセージ サービスから正常に削除されました。

MAPI_E_NOT_FOUND

lpUID パラメーターによって指されている MAPIUID が認識されませんでした。

注釈

IProviderAdmin::D eleteProvider メソッドは、サービス プロバイダーをメッセージ サービスから削除します。 DeleteProvider は、lpUID が指す MAPIUID 構造体を、アクティブなサービス プロバイダーによって登録された識別子のセットと照合することによって、削除するサービス プロバイダーを決定します。

ほとんどのメッセージ サービスでは、プロファイルの使用中にプロバイダーを削除することはできません。 削除するプロバイダーが使用中の場合、 DeleteProvider はすぐに削除するのではなく削除対象としてマークし、S_OKを返します。 プロバイダーが使用されなくなったら、削除されます。

DeleteProvider は 、プロバイダーがサービスから削除される前に、メッセージ サービスのエントリ ポイント関数を呼び出します。 ulContext パラメーターは、MSG_SERVICE_PROVIDER_DELETEに設定されます。 メッセージ サービス エントリ ポイント関数は、次のタスクを実行します。

  • サービス プロバイダーを削除します。

  • サービス プロバイダーのプロファイル セクションを削除します。

プロバイダーが削除された後、メッセージ サービス エントリ ポイント関数は再び呼び出されません。

関連項目

MAPIUID

MSGSERVICEENTRY

IProviderAdmin : IUnknown