ICertificateEnrollmentPolicyServerSetup ::GetProperty, méthode (casetup.h)
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 :
|
[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 |
---|---|
|
L’argument propertyId n’est pas membre du type d’énumération CEPSetupProperty. |
|
Le paramètre pPropertyValue ne peut pas être NULL. |
|
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour