IConnectedIdentityProvider::ConnectIdentity-Methode (identityprovider.h)
Stellt eine Identität mit einem Domänenbenutzer her.
Syntax
HRESULT ConnectIdentity(
[in] BYTE *AuthBuffer,
[in] ULONG AuthBufferSize
);
Parameter
[in] AuthBuffer
Ein Gemarstauthentifizierungspuffer SEC_WINNT_AUTH_IDENTITY_EX2 Struktur, die die Anmeldeinformationen der Onlineidentität enthält. Der Puffer kann vom Aufrufer mithilfe der CredPackAuthenticationBuffer-Funktion mit der Option CRED_PACK_ID_PROVIDER_CREDENTIALS erstellt oder von einem Anbieter von Onlineidentitätsanmeldeinformationen aus der CredUIPromptForWindowsCredentials-Funktion zurückgegeben werden. Der Puffer kann optional verschlüsselt werden, indem die SspiEncryptAuthIdentityEx-Funktion mit der Option SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON aufgerufen wird.
[in] AuthBufferSize
Größe des AuthBuffer-Parameters in Bytes.
Rückgabewert
Wenn die Methode erfolgreich ist, gibt S_OK zurück.
Wenn die Methode fehlschlägt, gibt einen Win32-Fehlercode zurück.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der Benutzername oder das Kennwort ist nicht korrekt. |
|
Der Domänenbenutzer ist bereits mit einer Onlineidentität dieses Anbieters verbunden oder zugeordnet. |
|
Das Format des Onlinebenutzernamens ist ungültig. |
Hinweise
Der AuthBuffer-Parameter kann im Systemkontext verschlüsselt werden, wenn die Anmeldeinformationen auf dem sicheren Desktop gesammelt werden. In diesem Fall kann der Identitätsanbieter die Anmeldeinformationen im aktuellen Prozess nicht entschlüsseln. Zum Entschlüsseln des Puffers muss der Identitätsanbieter die Anmeldeinformationen an einen Prozess senden, der im Systemkontext ausgeführt wird.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | identityprovider.h |