Condividi tramite

Metodo ICertificateEnrollmentPolicyServerSetup::UnInstall (casetup.h)

  • Articolo

Il metodo UnInstall rimuove il servizio Web CEP (Certificate Enrollment Policy).

Sintassi

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

Parametri

[in, optional] pAuthKeyBasedRenewal

Puntatore a una matrice VARIANT contenente il tipo di autenticazione e i valori facoltativi KeyBasedRenewal.

È possibile impostare i valori seguenti per il tipo di autenticazione nel primo elemento della matrice.

  • X509AuthKerberos
  • X509AuthUserName
  • X509AuthCertificate
Il secondo elemento (facoltativo) nel valore della matrice è VARIANT_TRUE per un CEP KeyBasedRenewal.

Valore restituito

Codice restituito Descrizione
E_ACCESSDENIED
 L'utente deve essere un amministratore locale.

Il valore della proprietà ErrorString è impostato su "È necessario essere l'amministratore del computer locale per eseguire questa configurazione".
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 L'oggetto ICertificateEnrollmentPolicyServerSetup è stato inizializzato. Un oggetto viene inizializzato quando si chiama InitializeInstallDefaults.

Il valore della proprietà ErrorString è impostato su "L'oggetto è stato inizializzato. Non è possibile chiamare UnInstall in un oggetto inizializzato."

Commenti

È possibile chiamare questo metodo per rimuovere il servizio CEP. Tuttavia, poiché non è possibile chiamare il metodo UnInstall in un oggetto ICertificateEnrollmentPolicyServerSetup già stato inizializzato, è necessario creare un nuovo oggetto ICertificateEnrollmentPolicyServerSetup prima di chiamare UnInstall.

Quando il parametro pAuthKeyBasedRenewal è NULL, questa funzione esegue le azioni seguenti:

  • Inizializza Strumentazione gestione Windows (WMI).
  • Tenta di eliminare la directory %Windir%\Systemdata\Cep e tutte le sottodirectory dell'applicazione che potrebbero esistere. Per altre informazioni, vedere la sezione Installa osservazioni.
  • Tenta di eliminare il pool di applicazioni e tutte le applicazioni nel pool.
  • Tenta di aggiornare il descrittore di sicurezza del contenitore Oggetti eliminati in Active Directory per negare l'accesso dal computer. Per altre informazioni, vedere la sezione Installa osservazioni.
Quando il parametro pAuthKeyBasedRenewal contiene valori per il tipo di autenticazione e KeyBasedRenewal, questa funzione esegue le azioni nell'elenco precedente, ma elimina solo l'applicazione che corrisponde ai valori impostati in pAuthKeyBasedRenewal e lascia altre applicazioni sul posto.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione casetup.h
DLL Certocm.dll

Vedi anche

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

Installazione