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

  • Artigo

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
S_OK
 O método foi bem-sucedido.
ERROR_LOGON_FAILURE
 O nome de usuário ou senha não está correto.
ERROR_USER_EXISTS
 O usuário de domínio já está conectado ou associado a uma identidade online desse provedor.
ERROR_INVALID_ACCOUNT_NAME
 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

Confira também

IConnectedIdentityProvider