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

Article
03/14/2023

La méthode GetProperty récupère une valeur d’énumération CEPSetupProperty pour la configuration du service web CEP (Certificate Enrollment Policy).

Syntaxe

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

Paramètres

[in] propertyId

Valeur de l’énumération CEPSetupProperty qui spécifie la valeur de propriété à définir. Les valeurs suivantes sont valides.

Valeur	Description
ENUM_CEPSETUPPROP_AUTHENTICATION	Le paramètre pPropertyValue contient une valeur qui identifie le type d’authentification à utiliser.
ENUM_CEPSETUPPROP_SSLCERTHASH	Le paramètre pPropertyValue contient un hachage du certificat, le cas échéant, utilisé lors de l’authentification.
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL	Le paramètre pPropertyValue spécifie s’il faut configurer le serveur de stratégie d’inscription dans un mode qui retourne des stratégies pour les modèles KeyBasedRenewal uniquement.
ENUM_CEPSETUPPROP_URL	Contient l’URL du service CEP. 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_cep_AuthenticationType/service.svc/cep », où le type d’authentification peut être l’un des suivants : Kerberos usernamepassword certificat

[out] pPropertyValue

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

Si vous spécifiez ENUM_CEPSETUPPROP_AUTHENTICATION dans le paramètre propertyId , le paramètre pPropertyValue contient l’une des constantes suivantes si la méthode GetProperty retourne correctement :

X509AuthKerberos
X509AuthUsername
X509AuthCertificate

Si vous spécifiez ENUM_CEPSETUPPROP_SSLCERTHASH dans le paramètre propertyId , le paramètre pPropertyValue contient un sous-type VT_BSTR qui contient le hachage si la méthode GetProperty retourne correctement.

Si vous spécifiez ENUM_CEPSETUPPROP_AUTHENTICATION dans le paramètre propertyId , le paramètre pPropertyValue contient la procédure d’authentification.

Si vous spécifiez ENUM_CEPSETUPPROP_URL dans le paramètre propertyId , le paramètre pPropertyValue contient l’URL du service web CEP (Certificate Enrollment Policy).

Si vous spécifiez ENUM_CEPSETUPPROP_KEYBASED_RENEWAL dans le paramètre propertyId , vous devez définir le paramètre pPropertyValue sur le sous-type VT_BOOL qui indique s’il faut configurer le serveur de stratégie d’inscription dans un mode qui retourne des stratégies pour les modèles KeyBasedRenewal uniquement.

Valeur retournée

Code de retour	Description
E_INVALIDARG	L’argument propertyId n’est pas membre du type d’énumération CEPSetupProperty.
E_POINTER	Le paramètre pPropertyValue ne peut pas être NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	L’objet ICertificateEnrollmentPolicyServerSetup 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. »

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

setProperty

Partager via