Partager via


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

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