Partager via

IPolicyQualifier ::InitializeEncode, méthode (certenroll.h)

La méthode InitializeEncode initialise l’objet à partir d’une chaîne et 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 Meaning
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 à afficher par l’application à tout utilisateur qui s’appuie sur le certificat. L’utilisateur remarque que 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 incluent, mais ne sont pas limitées à celles du tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Code de retour Descriptif
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 règles d’encodage unique (DER). L’URL est encodée en tant que chaîne IA5 ( Abstract Syntax Notation One ) (ASN.1).

Si vous spécifiez PolicyQualifierTypeUserNotice 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_USERNOTICE (1.3.6.1.5.5.7.2.2) OID 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.

Spécifications

Requirement Valeur
Client minimum requis Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
plateforme cible Fenêtres
Header certenroll.h
DLL CertEnroll.dll

Voir aussi

IPolicyQualifier

  • Last updated on