IWSDSSLClientCertificate::GetMappedAccessToken-Methode (wsdbase.h)
Ruft das zugeordnete Zugriffstoken ab.
Syntax
HRESULT GetMappedAccessToken(
[in, out] HANDLE *phToken
);
Parameter
[in, out] phToken
Ein Handle für das zugeordnete Zugriffstoken. Nach Abschluss des Vorgangs muss der Aufrufer das Handle durch Aufrufen von CloseHandle freigeben.
Rückgabewert
Mögliche Rückgabewerte sind u. a. die folgenden:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Methode war erfolgreich. |
|
Das token, das dem angegebenen Handle zugeordnet ist, ist nicht verfügbar. |
Hinweise
Wenn das Clientzertifikat erfolgreich einem Betriebssystembenutzerkonto zugeordnet wurde, wird über phToken ein gültiges Zugriffstoken für diesen Benutzer zurückgegeben. Dieses Token kann verwendet werden, um die Identität des Benutzers zu annehmen. Intern führen HTTP.sys das Clientzertifikat für die Benutzerkontozuordnung aus und geben diese Informationen über die HTTP_SSL_CLIENT_CERT_INFO-Struktur zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wsdbase.h (include Wsdapi.h) |
| DLL | Wsdapi.dll |