Metodo IConnectedIdentityProvider::ConnectIdentity (identityprovider.h)

  • Articolo

Connette un'identità a un utente di dominio.

Sintassi

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

Parametri

[in] AuthBuffer

Buffer di autenticazione con marshalling SEC_WINNT_AUTH_IDENTITY_EX2 struttura che contiene le credenziali dell'identità online. Il buffer può essere costruito dal chiamante usando la funzione CredPackAuthenticationBuffer con l'opzione CRED_PACK_ID_PROVIDER_CREDENTIALS o restituita da un provider di credenziali di identità online dalla funzione CredUIPromptForWindowsCredentials . Il buffer può essere crittografato facoltativamente chiamando la funzione SspiEncryptAuthIdentityEx con l'opzione SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON.

[in] AuthBufferSize

Dimensioni, in byte, del parametro AuthBuffer .

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK.

Se il metodo ha esito negativo, restituisce un codice di errore Win32.

Codice restituito Descrizione
S_OK
 Il metodo è riuscito.
ERROR_LOGON_FAILURE
 Il nome utente o la password non sono corretti.
ERROR_USER_EXISTS
 L'utente di dominio è già connesso o associato a un'identità online da questo provider.
ERROR_INVALID_ACCOUNT_NAME
 Il formato del nome utente online non è valido.

Commenti

Il parametro AuthBuffer può essere crittografato nel contesto di sistema se le credenziali vengono raccolte sul desktop protetto. In tal caso, il provider di identità non può decrittografare le credenziali nel processo corrente. Per decrittografare il buffer, il provider di identità dovrà inviare le credenziali a un processo in esecuzione nel contesto di sistema.

Requisiti

   
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione identityprovider.h

Vedi anche

IConnectedIdentityProvider