Partager via

ICertificateEnrollmentPolicyServerSetup ::UnInstall, méthode (casetup.h)

  • Article

La méthode UnInstall supprime le service Web CEP (Certificate Enrollment Policy).

Syntaxe

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

Paramètres

[in, optional] pAuthKeyBasedRenewal

Pointeur vers un tableau VARIANT qui contient le type d’authentification et les valeurs KeyBasedRenewal facultatives.

Vous pouvez définir les valeurs suivantes pour le type d’authentification dans le premier élément du tableau.

  • X509AuthKerberos
  • X509AuthUserName
  • X509AuthCertificate
Le deuxième élément (facultatif) de la valeur du tableau est VARIANT_TRUE pour un CEP KeyBasedRenewal.

Valeur retournée

Code de retour Description
E_ACCESSDENIED
 L’utilisateur doit être un administrateur local.

La valeur de la propriété ErrorString est définie sur « Vous devez être administrateur de l’ordinateur local pour exécuter cette configuration ».
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 L’objet ICertificateEnrollmentPolicyServerSetup a été initialisé. Un objet est initialisé lorsque vous appelez avec succès InitializeInstallDefaults.

La valeur de la propriété ErrorString est définie sur « L’objet a été initialisé. Vous ne pouvez pas appeler UnInstall sur un objet initialisé. »

Remarques

Vous pouvez appeler cette méthode pour supprimer le service CEP. Toutefois, étant donné que vous ne pouvez pas appeler la méthode UnInstall sur un objet ICertificateEnrollmentPolicyServerSetup qui a déjà été initialisé, vous devez créer un nouvel ICertificateEnrollmentPolicyServerSetup avant d’appeler UnInstall.

Lorsque le paramètre pAuthKeyBasedRenewal a la valeur NULL, cette fonction effectue les actions suivantes :

  • Initialise Windows Management Instrumentation (WMI).
  • Tente de supprimer le répertoire %Windir%\Systemdata\Cep et tous les sous-répertoires d’application qui peuvent exister. Pour plus d’informations, consultez la section Installer les remarques.
  • Tente de supprimer le pool d’applications et toutes les applications du pool.
  • Tente de mettre à jour le descripteur de sécurité du conteneur Objets supprimés dans Active Directory pour refuser l’accès par l’ordinateur. Pour plus d’informations, consultez la section Installer les remarques.
Lorsque le paramètre pAuthKeyBasedRenewal contient des valeurs pour le type d’authentification et KeyBasedRenewal, cette fonction effectue les actions de la liste précédente, mais supprime uniquement l’application qui correspond aux valeurs définies dans pAuthKeyBasedRenewal et laisse les autres applications en place.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête casetup.h
DLL Certocm.dll

Voir aussi

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

Installer