Méthode IPolicyQualifier ::InitializeEncode (certenroll.h)

Article
08/22/2023

La méthode InitializeEncode initialise l’objet à partir d’une chaîne et d’une valeur qui identifie le type de qualificateur.

Syntaxe

HRESULT InitializeEncode(
  [in] BSTR                strQualifier,
  [in] PolicyQualifierType Type
);

Paramètres

[in] strQualifier

Variable BSTR qui contient le qualificateur.

[in] Type

Valeur d’énumération PolicyQualifierType qui spécifie le type de qualificateur appliqué à une stratégie de certificat. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
PolicyQualifierTypeUnknown	Le type de qualificateur n’est pas spécifié.
PolicyQualifierTypeUrl	Le qualificateur est une URL qui pointe vers une déclaration de pratique de certification (CPS) qui a été définie par l’autorité de certification pour décrire les stratégies sous lesquelles le certificat a été émis et les objectifs pour lesquels le certificat peut être utilisé.
PolicyQualifierTypeUserNotice	Le qualificateur est une instruction de texte que l’application doit afficher à tout utilisateur qui s’appuie sur le certificat. L’avis de l’utilisateur identifie les utilisations autorisées du certificat.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Code de retour	Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	L’objet est déjà initialisé.

Remarques

Si vous spécifiez PolicyQualifierTypeUrl dans le paramètre Type, cette méthode associe la chaîne entrée dans le paramètre strQualifier au XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1) identificateur d’objet (OID) et l’encode à l’aide de Distinguished Encoding Rules (DER). L’URL est encodée en tant que chaîne IA5 ASN.1 ( Abstract Syntax Notation One ).

Si vous spécifiez PolicyQualifierTypeUserNotice dans le paramètre Type , cette méthode associe la chaîne entrée dans le paramètre strQualifier à l’OID XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE (1.3.6.1.5.5.7.2.2) et l’encode à l’aide de DER.

Vous pouvez récupérer les propriétés suivantes pour cet objet :

La propriété ObjectId récupère un OID qui identifie si le qualificateur est un CPS ou une notification utilisateur.
La propriété Qualifier récupère la chaîne spécifiée pour le paramètre strQualifier de la méthode InitializeEncode .
La propriété RawData récupère le qualificateur encodé en DER.
La propriété Type récupère une valeur de l’énumération PolicyQualifierType qui spécifie le type de qualificateur.

Configuration requise

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

Voir aussi

IPolicyQualifier

Partager via