Ix509AttributeOSVersion ::InitializeEncode, méthode (certenroll.h)
La méthode InitializeEncode initialise l’attribut à partir des informations de version du système d’exploitation.
Syntaxe
HRESULT InitializeEncode(
[in, optional] BSTR strOSVersion
);
Paramètres
[in, optional] strOSVersion
Variable BSTR qui contient les informations de version. Le format de la chaîne est major.minor.build.platform. Ce paramètre est facultatif. Si vous ne spécifiez pas de chaîne, cette méthode appelle la fonction GetVersionEx .
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. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
Remarques
L’identificateur d’objet (OID) pour cet attribut est XCN_OID_OS_VERSION (1.3.6.1.4.1.311.13.2.3). Pour plus d’informations, consultez CERTENROLL_OBJECTID.
Vous devez appeler InitializeEncode ou InitializeDecode avant de pouvoir utiliser un objet IX509AttributeOSVersion . Les deux méthodes se complètent. La méthode InitializeEncode vous permet de construire une structure ASN.1 ( Abstract Syntax Notation One ) codée à partir de données brutes, et la méthode InitializeDecode vous permet d’initialiser des données brutes à partir d’une structure ASN.1 encodée. Vous pouvez appeler la propriété OSVersion pour récupérer les données brutes.
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 |