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

  • Artículo

Conecta una identidad a un usuario de dominio.

Sintaxis

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

Parámetros

[in] AuthBuffer

Un búfer de autenticación serializado SEC_WINNT_AUTH_IDENTITY_EX2 estructura que contiene la credencial de la identidad en línea. El autor de la llamada puede construir el búfer mediante la función CredPackAuthenticationBuffer con la opción CRED_PACK_ID_PROVIDER_CREDENTIALS o devuelto por un proveedor de credenciales de identidad en línea de la función CredUIPromptForWindowsCredentials . El búfer se puede cifrar opcionalmente llamando a la función SspiEncryptAuthIdentityEx con la opción SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON.

[in] AuthBufferSize

Tamaño, en bytes, del parámetro AuthBuffer .

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK.

Si se produce un error en el método, devuelve un código de error win32.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
ERROR_LOGON_FAILURE
 El nombre de usuario o la contraseña no son correctos.
ERROR_USER_EXISTS
 El usuario del dominio ya está conectado o asociado a una identidad en línea de este proveedor.
ERROR_INVALID_ACCOUNT_NAME
 El formato del nombre de usuario en línea no es válido.

Comentarios

El parámetro AuthBuffer se puede cifrar en el contexto del sistema si la credencial se recopila en el escritorio seguro. En ese caso, el proveedor de identidades no puede descifrar la credencial en el proceso actual. Para descifrar el búfer, el proveedor de identidades deberá enviar la credencial a un proceso que se ejecuta en el contexto del sistema.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado identityprovider.h

Consulte también

IConnectedIdentityProvider