Método IConnectedIdentityProvider::ConnectIdentity (identityprovider.h)
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 |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
El nombre de usuario o la contraseña no son correctos. |
|
El usuario del dominio ya está conectado o asociado a una identidad en línea de este proveedor. |
|
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 |