IProviderAdmin::DeleteProviderIProviderAdmin::DeleteProvider

適用されます: OutlookApplies to: Outlook

メッセージ サービスからサービス プロバイダーを削除します。Deletes a service provider from the message service.

HRESULT DeleteProvider(
  LPMAPIUID lpUID
);

ParametersParameters

lpUIDlpUID

[で [チェック アウト]削除するプロバイダーを表す一意の識別子を格納するMAPIUID構造体へのポインター。[in, out] A pointer to the MAPIUID structure that contains the unique identifier that represents the provider to delete.

�߂�lReturn value

S_OKS_OK

プロバイダーは、メッセージ サービスから正しく削除されました。The provider was successfully deleted from the message service.

MAPI_E_NOT_FOUNDMAPI_E_NOT_FOUND

_LpUID_パラメーターで指定されたMAPIUIDが認識されませんでした。The MAPIUID pointed to by the lpUID parameter was not recognized.

備考Remarks

IProviderAdmin::DeleteProviderメソッドは、メッセージ サービスのサービス プロバイダーを削除します。The IProviderAdmin::DeleteProvider method deletes a service provider from the message service. DeleteProviderは、アクティブなサービスのプロバイダーが登録されている識別子のセットを_lpUID_で指定されたMAPIUID構造を照合することによって削除するのにはサービス ・ プロバイダーを決定します。DeleteProvider determines the service provider to delete by matching the MAPIUID structure pointed to by lpUID with the set of identifiers registered by the active service providers.

メッセージ サービスのほとんどは、プロバイダー プロファイルを使用している間に削除するには許可されません。Most message services do not allow providers to be deleted while the profile is in use. 削除するプロバイダーを使用している場合DeleteProviderはすぐに削除する代わりに削除のマークが付けし、S_OK を返します。If the provider to delete is in use, DeleteProvider marks it for deletion instead of removing it immediately and returns S_OK. プロバイダーが使用されていないがときに、削除されます。When the provider is no longer being used, it is deleted.

DeleteProviderは、プロバイダーがサービスから削除される前に、メッセージ サービスのエントリ ポイント関数を呼び出します。DeleteProvider calls the message service's entry point function before the provider is removed from the service. _UlContext_パラメーターは、MSG_SERVICE_PROVIDER_DELETE に設定されます。The ulContext parameter is set to MSG_SERVICE_PROVIDER_DELETE. メッセージ サービスのエントリ ポイント関数は、次のタスクを実行します。The message service entry point function performs the following tasks:

  • サービス プロバイダーを削除します。Deletes the service provider.

  • サービス プロバイダーのプロファイル セクションを削除します。Deletes the service provider's profile section.

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

関連項目See also

MAPIUIDMAPIUID

MSGSERVICEENTRYMSGSERVICEENTRY

IProviderAdmin: IUnknownIProviderAdmin : IUnknown