Méthode ICertAdmin2::GetMyRoles (certadm.h)

Article
08/22/2023

La méthode GetMyRoles récupère les rôles d’autorité de certification de l’appelant.

Syntaxe

HRESULT GetMyRoles(
  [in]  const BSTR strConfig,
  [out] LONG       *pRoles
);

Paramètres

[in] strConfig

Valeur de chaîne qui 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.

Important :GetMyRoles n’efface pas le cache interne lorsque la chaîne de configuration est modifiée. Lorsque vous modifiez la chaîne de configuration de l’autorité de certification, vous devez instancier un nouvel objet ICertAdmin et appeler à nouveau cette méthode avec la nouvelle chaîne de configuration.

[out] pRoles

Pointeur vers une valeur LONG qui représente les rôles d’autorité de certification récupérés pour l’appelant. Il peut s’agir d’une combinaison de bits de zéro ou plus des valeurs suivantes.

Valeur	Signification
CA_ACCESS_ADMIN 0x1	L’appelant dispose d’une capacité d’administrateur d’autorité de certification.
CA_ACCESS_AUDITOR 0x4	L’appelant dispose d’une capacité d’auditeur d’autorité de certification.
CA_ACCESS_ENROLL 0x200	L’appelant a accès à l’inscription.
CA_ACCESS_OFFICER 0x2	L’appelant a une capacité d’agent d’autorité de certification.
CA_ACCESS_OPERATOR 0x8	L’appelant dispose d’une fonctionnalité de sauvegarde de l’autorité de certification.
CA_ACCESS_READ 0x100	L’appelant dispose d’un accès en lecture d’autorité de certification.

Valeur retournée

C++

Si la fonction réussit, la valeur de retour est S_OK.

Si la fonction échoue, la valeur de retour est un HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

VB

La valeur de retour est une valeur de type Long qui représente les rôles d’autorité de certification récupérés pour l’appelant. Il peut s’agir d’une combinaison de bits de zéro ou plus des valeurs suivantes.

Code/valeur de retour	Description
CA_ACCESS_ADMIN 0x1	L’appelant dispose d’une capacité d’administrateur d’autorité de certification.
CA_ACCESS_AUDITOR 0x4	L’appelant dispose d’une capacité d’auditeur d’autorité de certification.
CA_ACCESS_ENROLL 0x200	L’appelant a accès à l’inscription.
CA_ACCESS_OFFICER 0x2	L’appelant a une capacité d’agent d’autorité de certification.
CA_ACCESS_OPERATOR 0x8	L’appelant dispose d’une fonctionnalité de sauvegarde de l’autorité de certification.
CA_ACCESS_READ 0x100	L’appelant dispose d’un accès en lecture.

Configuration requise


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	certadm.h (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll

Voir aussi

ICertAdmin2

Partager via