Metodo IConnectedIdentityProvider::ConnectIdentity (identityprovider.h)
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 |
---|---|
|
Il metodo è riuscito. |
|
Il nome utente o la password non sono corretti. |
|
L'utente di dominio è già connesso o associato a un'identità online da questo provider. |
|
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 |