Partager via

Méthode ICertificateEnrollmentServerSetup ::GetProperty (casetup.h)

  • Article

La méthode GetProperty récupère une valeur d’énumération CESSetupProperty pour la configuration du service web d’inscription de certificats (CES).

Syntaxe

HRESULT GetProperty(
  [in]  CESSetupProperty propertyId,
  [out] VARIANT          *pPropertyValue
);

Paramètres

[in] propertyId

Valeur d’énumération CESSetupProperty qui spécifie la valeur de propriété à récupérer. Pour plus d'informations, consultez la section Notes.

[out] pPropertyValue

Pointeur vers une variable VARIANT qui contient la valeur de la propriété.

Valeur retournée

Code de retour Description
E_INVALIDARG
 L’argument propertyId n’est pas membre du type d’énumération CESSetupProperty.
E_POINTER
 Le paramètre pPropertyValue ne peut pas être NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 L’objet ICertificateEnrollmentServerSetup n’a pas été initialisé.

La valeur de la propriété ErrorString est définie sur « L’objet setup n’a pas été initialisé. Initialisez l’objet setup avec la méthode InitializeInstallDefaults. »

Remarques

Le type d’énumération CESSetupProperty contient les valeurs suivantes :

  • ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY
  • ENUM_CESSETUPPROP_CACONFIG
  • ENUM_CESSETUPPROP_AUTHENTICATION
  • ENUM_CESSETUPPROP_SSLCERTHASH
  • ENUM_CESSETUPPROP_URL
  • ENUM_CESSETUPPROP_RENEWALONLY

Ces valeurs ont les significations suivantes :

  • La propriété ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY est une valeur VT_BOOL qui spécifie si le contexte du serveur est ApplicationPoolIdentity.
  • La propriété ENUM_CESSETUPPROP_CACONFIG contient une chaîne de configuration d’autorité de certification (VT_BSTR) au format computerDNSname/CAName où computerDNSname est le nom DNS complet du serveur et CAName est le nom commun de l’autorité de certification.
  • La propriété ENUM_CESSETUPPROP_AUTHENTICATION spécifie le type de procédure d’authentification utilisée. Si la méthode GetProperty retourne correctement, l’argument pPropertyValue contient l’une des constantes suivantes :
    • X509AuthKerberos
    • X509AuthUsername
    • X509AuthCertificate
  • La propriété ENUM_CESSETUPPROP_SSLCERTHASH contient le hachage (VT_BSTR) du certificat utilisé lors de l’authentification. La propriété ENUM_CESSETUPPROP_AUTHENTICATION doit être définie sur X509AuthCertificate.
  • La propriété ENUM_CESSETUPPROP_URL contient l’URL du service CES. Si la méthode GetProperty retourne correctement, l’argument pPropertyValue contient un sous-type VT_BSTR qui contient une URL de la forme « https:// computerDNSname/ADPolicyProvider_ces_AuthenticationType/service.svc/ces » où le type d’authentification peut être l’un des suivants :
    • Kerberos
    • usernamepassword
    • certificat
  • La propriété ENUM_CESSETUPPROP_RENEWALONLY est une valeur VT_BOOL qui spécifie si CES peut traiter uniquement les renouvellements de certificat.

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

ICertificateEnrollmentServerSetup