ICertificateEnrollmentPolicyServerSetup::UnInstall メソッド (casetup.h)

  • [アーティクル]

UnInstall メソッドは、証明書登録ポリシー (CEP) Web サービスを削除します。

構文

HRESULT UnInstall(
  [in, optional] VARIANT *pAuthKeyBasedRenewal
);

パラメーター

[in, optional] pAuthKeyBasedRenewal

認証の種類とオプションの KeyBasedRenewal 値を含む VARIANT 配列へのポインター。

配列の最初の要素では、認証の種類に次の値を設定できます。

  • X509AuthKerberos
  • X509AuthUserName
  • X509AuthCertificate
配列値の 2 番目の (省略可能な) 要素は、KeyBasedRenewal CEP に対して VARIANT_TRUE されます。

戻り値

リターン コード 説明
E_ACCESSDENIED
 ユーザーはローカル管理者である必要があります。

ErrorString プロパティの値は、"このセットアップを実行するには、ローカル コンピューター管理者である必要があります" に設定されています。
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 ICertificateEnrollmentPolicyServerSetup オブジェクトが初期化されました。 InitializeInstallDefaults を正常に呼び出すと、オブジェクトが初期化されます。

ErrorString プロパティの値が "オブジェクトが初期化されました。 初期化されたオブジェクトに対して UnInstall を呼び出すことはできません。

注釈

このメソッドを呼び出して、CEP サービスを削除できます。 ただし、既に初期化されている ICertificateEnrollmentPolicyServerSetup オブジェクトで UnInstall メソッドを呼び出すことはできないため、UnInstall を呼び出す前に新しい ICertificateEnrollmentPolicyServerSetup を作成する必要があります。

pAuthKeyBasedRenewal パラメーターが NULL の場合、この関数は次のアクションを実行します。

  • Windows Management Instrumentation (WMI) を初期化します。
  • %Windir%\Systemdata\Cep ディレクトリと、存在する可能性があるすべてのアプリケーション サブディレクトリの削除を試みます。 詳細については、「 インストール の備考」セクションを参照してください。
  • アプリケーション プールとプール内のすべてのアプリケーションの削除を試みます。
  • Active Directory の Deleted Objects コンテナーのセキュリティ記述子を更新して、コンピューターによるアクセスを拒否しようとします。 詳細については、「 インストール の備考」セクションを参照してください。
pAuthKeyBasedRenewal パラメーターに認証の種類と KeyBasedRenewal の値が含まれている場合、この関数は前の一覧のアクションを実行しますが、pAuthKeyBasedRenewal で設定された値に対応するアプリケーションのみを削除し、他のアプリケーションはそのままにします。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー casetup.h
[DLL] Certocm.dll

こちらもご覧ください

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

インストール