Método IConnectedIdentityProvider::ConnectIdentity (identityprovider.h)
Conecta uma identidade a um usuário de domínio.
Sintaxe
HRESULT ConnectIdentity(
[in] BYTE *AuthBuffer,
[in] ULONG AuthBufferSize
);
Parâmetros
[in] AuthBuffer
Um buffer de autenticação marshaled SEC_WINNT_AUTH_IDENTITY_EX2 estrutura que contém a credencial da identidade online. O buffer pode ser construído pelo chamador usando a função CredPackAuthenticationBuffer com a opção CRED_PACK_ID_PROVIDER_CREDENTIALS ou retornado por um provedor de credenciais de identidade online da função CredUIPromptForWindowsCredentials . Opcionalmente, o buffer pode ser criptografado chamando a função SspiEncryptAuthIdentityEx com a opção SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON.
[in] AuthBufferSize
Tamanho, em bytes, do parâmetro AuthBuffer .
Valor retornado
Se o método for bem-sucedido, retornará S_OK.
Se o método falhar, retornará um código de erro Win32.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
O nome de usuário ou senha não está correto. |
|
O usuário de domínio já está conectado ou associado a uma identidade online desse provedor. |
|
O formato do nome de usuário online não é válido. |
Comentários
O parâmetro AuthBuffer poderá ser criptografado no contexto do sistema se a credencial for coletada na área de trabalho segura. Nesse caso, o provedor de identidade não pode descriptografar a credencial no processo atual. Para descriptografar o buffer, o provedor de identidade precisará enviar a credencial para um processo em execução no contexto do sistema.
Requisitos
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | identityprovider.h |