ICertRequest2 ::GetCAProperty, méthode (certcli.h)

Article
02/23/2024

La méthode GetCAProperty récupère une valeur de propriété pour l’autorité de certification (CA). Les fonctionnalités de cette méthode sont identiques à ICertAdmin2 ::GetCAProperty. Pour plus d’informations sur cette méthode, consultez ICertAdmin2 ::GetCAProperty.

Syntaxe

HRESULT GetCAProperty(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [in]          LONG       PropIndex,
  [in]          LONG       PropType,
  [in]          LONG       Flags,
  [out, retval] VARIANT    *pvarPropertyValue
);

Paramètres

[in] strConfig

Représente une chaîne de configuration valide pour l’autorité de certification sous la forme COMPUTERNAME\CANAME, où COMPUTERNAME est le nom réseau du serveur des services de certificats et CANAME est le nom commun de l’autorité de certification, tel qu’entré lors de l’installation des services de certificats. Pour plus d’informations sur le nom de la chaîne de configuration, consultez ICertConfig.

[in] PropId

Spécifie l’identificateur de propriété. Pour plus d’informations sur ce paramètre, consultez le tableau dans ICertAdmin2 ::GetCAProperty.

[in] PropIndex

Si PropId est indexé, l’index de base zéro à utiliser lors de la récupération de la valeur de la propriété. Si PropId n’est pas indexé, cette valeur est ignorée.

[in] PropType

Spécifie le type de la propriété, qui correspond à la colonne Type dans la table PropId . Le type peut être l’un des types suivants.

Valeur	Signification
PROPTYPE_LONG	Données longues signées
PROPTYPE_DATE	Date/heure (réservée pour une utilisation ultérieure)
PROPTYPE_BINARY	Données binaires
PROPTYPE_STRING	Données de chaîne Unicode

[in] Flags

Les indicateurs suivants peuvent être utilisés pour spécifier le format de la valeur de propriété retournée ; ces indicateurs ont une signification uniquement pour les données binaires (telles que les certificats, les chaînes de certificats ou les listes de révocation de certificats) et sont ignorés dans le cas contraire.

Valeur	Signification
CV_OUT_BASE64	BASE64 sans BEGIN/END
CV_OUT_BASE64HEADER	BASE64 avec BEGIN CERTIFICATE et END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER	BASE64 avec BEGIN NEW CERTIFICATE REQUEST et END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER	BASE64 avec la liste de révocation de certificats BEGIN X509 et END X509 CRL
CV_OUT_BINARY	Binary
CV_OUT_HEX	Chaîne hexadécimale
CV_OUT_HEXADDR	Chaîne hexadécimale avec adresse/décalage
CV_OUT_HEXASCII	Chaîne hexadécimale avec ASCII
CV_OUT_HEXASCIIADDR	Chaîne hexadécimale avec ASCII et address/offset

[out, retval] pvarPropertyValue

Pointeur vers un VARIANT qui reçoit la valeur de propriété demandée.

Une fois que vous avez terminé d’utiliser variant, libérez-le en appelant la fonction VariantClear .

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

VB

La valeur de retour est un Variant qui reçoit la valeur de propriété demandée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certcli.h (inclure Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certcli.dll

Voir aussi

CCertRequest

ICertRequest

ICertRequest2

Partager via