Partager via

Méthode IConnectedIdentityProvider::ConnectIdentity (identityprovider.h)

  • Article

Connecte une identité à un utilisateur de domaine.

Syntaxe

HRESULT ConnectIdentity(
  [in] BYTE  *AuthBuffer,
  [in] ULONG AuthBufferSize
);

Paramètres

[in] AuthBuffer

Une mémoire tampon d’authentification marshalée SEC_WINNT_AUTH_IDENTITY_EX2 structure qui contient les informations d’identification de l’identité en ligne. La mémoire tampon peut être construite par l’appelant à l’aide de la fonction CredPackAuthenticationBuffer avec l’option CRED_PACK_ID_PROVIDER_CREDENTIALS ou renvoyée par un fournisseur d’informations d’identification d’identité en ligne à partir de la fonction CredUIPromptForWindowsCredentials . La mémoire tampon peut être chiffrée éventuellement en appelant la fonction SspiEncryptAuthIdentityEx avec l’option SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON.

[in] AuthBufferSize

Taille, en octets, du paramètre AuthBuffer .

Valeur retournée

Si la méthode réussit, retourne S_OK.

Si la méthode échoue, retourne un code d’erreur Win32.

Code de retour Description
S_OK
 S_OK
ERROR_LOGON_FAILURE
 Le nom d’utilisateur ou le mot de passe n’est pas correct.
ERROR_USER_EXISTS
 L’utilisateur de domaine est déjà connecté ou associé à une identité en ligne à partir de ce fournisseur.
ERROR_INVALID_ACCOUNT_NAME
 Le format du nom d’utilisateur en ligne n’est pas valide.

Notes

Le paramètre AuthBuffer peut être chiffré dans le contexte système si les informations d’identification sont collectées sur le bureau sécurisé. Dans ce cas, le fournisseur d’identité ne peut pas déchiffrer les informations d’identification dans le processus en cours. Pour déchiffrer la mémoire tampon, le fournisseur d’identité doit envoyer les informations d’identification à un processus qui s’exécute dans le contexte système.

Configuration requise

   
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête identityprovider.h

Voir aussi

IConnectedIdentityProvider