Partager via


Méthode IWSDSSLClientCertificate ::GetMappedAccessToken (wsdbase.h)

Obtient le jeton d’accès mappé.

Syntaxe

HRESULT GetMappedAccessToken(
  [in, out] HANDLE *phToken
);

Paramètres

[in, out] phToken

Handle pour le jeton d’accès mappé. Une fois l’opération terminée, l’appelant doit libérer le handle en appelant CloseHandle.

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour Description
S_OK
La méthode a réussi.
S_FALSE
Le jeton associé au handle spécifié n’est pas disponible.

Remarques

Si le certificat client a été correctement mappé à un compte d’utilisateur du système d’exploitation, un jeton d’accès valide pour cet utilisateur est retourné via phToken. Ce jeton peut être utilisé pour emprunter l’identité de l’utilisateur. En interne, HTTP.sys effectue le mappage du certificat client au compte d’utilisateur et retourne ces informations via la structure HTTP_SSL_CLIENT_CERT_INFO .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wsdbase.h (inclure Wsdapi.h)
DLL Wsdapi.dll

Voir aussi

IWSDSSLClientCertificate