Función SspiGetCredUIContext (sspi.h)

Artículo
03/05/2024

Recupera información de contexto de un proveedor de credenciales.

Sintaxis

SECURITY_STATUS SEC_ENTRY SspiGetCredUIContext(
  [in]  HANDLE                           ContextHandle,
  [in]  GUID                             *CredType,
  [in]  LUID                             *LogonId,
  [out] PSEC_WINNT_CREDUI_CONTEXT_VECTOR *CredUIContexts,
  [out] HANDLE                           *TokenHandle
);

Parámetros

[in] ContextHandle

Puntero a una estructura de SEC_WINNT_CREDUI_CONTEXT recuperada durante una llamada anterior a la función SspiUnmarshalCredUIContext .

[in] CredType

Tipo de credencial especificada por el parámetro ContextHandle . Puede ser uno de los siguientes valores.

Valor	Significado
SEC_WINNT_AUTH_DATA_TYPE_PASSWORD 0x28bfc32f, 0x10f6, 0x4738, 0x98, 0xd1, 0x1a, 0xc0, 0x61, 0xdf, 0x71, 0x6a	La credencial es una contraseña.
SEC_WINNT_AUTH_DATA_TYPE_CERT 0x235f69ad, 0x73fb, 0x4dbc, 0x82, 0x3, 0x6, 0x29, 0xe7, 0x39, 0x33, 0x9b	La credencial es un certificado.
SEC_WINNT_AUTH_DATA_TYPE_CSP_DATA 0x68fd9879, 0x79c, 0x4dfe, 0x82, 0x81, 0x57, 0x8a, 0xad, 0xc1, 0xc1, 0x0	La credencial es datos de autenticación de un proveedor de servicios criptográficos (CSP).

[in] LogonId

Identificador de inicio de sesión asociado a la credencial especificada por el parámetro ContextHandle .

El autor de la llamada debe ejecutarse como LocalSystem para especificar un identificador de inicio de sesión.

[out] CredUIContexts

Puntero a una estructura de SEC_WINNT_CREDUI_CONTEXT_VECTOR que especifica el desplazamiento y el tamaño de los datos de la estructura especificada por el parámetro ContextHandle .

[out] TokenHandle

Identificador del token del usuario especificado.

Valor devuelto

Si la función se ejecuta correctamente, devuelve SEC_E_OK.

Si se produce un error en la función, devuelve un código de error distinto de cero.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	sspi.h
Library	Credui.lib
Archivo DLL	Credui.dll

Share via