LSA_CONVERT_AUTH_DATA_TO_TOKEN función de devolución de llamada (ntsecpkg.h)

Artículo
02/29/2024

La función ConvertAuthDataToToken crea un token de acceso a partir de los datos de autorización devueltos desde las funciones GetAuthDataForUser o GetUserAuthData .

Sintaxis

LSA_CONVERT_AUTH_DATA_TO_TOKEN LsaConvertAuthDataToToken;

NTSTATUS LsaConvertAuthDataToToken(
  [in]  PVOID UserAuthData,
  [in]  ULONG UserAuthDataSize,
  [in]  SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]  PTOKEN_SOURCE TokenSource,
  [in]  SECURITY_LOGON_TYPE LogonType,
  [in]  PUNICODE_STRING AuthorityName,
  [out] PHANDLE Token,
  [out] PLUID LogonId,
  [out] PUNICODE_STRING AccountName,
  [out] PNTSTATUS SubStatus
)
{...}

Parámetros

[in] UserAuthData

Puntero a los datos de autorización recibidos de las funciones GetAuthDataForUser o GetUserAuthData .

[in] UserAuthDataSize

Tamaño, en bytes, de los datos de autorización especificados por el parámetro UserAuthData .

[in] ImpersonationLevel

Valor de SECURITY_IMPERSONATION_LEVEL que especifica el nivel de suplantación para el token que se va a crear.

[in] TokenSource

Puntero a una estructura de TOKEN_SOURCE que especifica el origen que se va a registrar en el token.

[in] LogonType

Valor SECURITY_LOGON_TYPE que indica el tipo de inicio de sesión que se va a registrar en el token.

[in] AuthorityName

Puntero a una estructura de UNICODE_STRING que especifica el nombre de la autoridad que autorizó a este usuario, normalmente un nombre de dominio.

[out] Token

Puntero a un identificador que recibe el identificador del token de usuario.

Cuando haya terminado de usar el token de usuario, libere el identificador mediante una llamada a CloseHandle.

[out] LogonId

Puntero a un LUID que recibe el identificador de inicio de sesión del token.

[out] AccountName

Puntero a una estructura de UNICODE_STRING que recibe el nombre de cuenta codificado en el parámetro UserAuthData .

[out] SubStatus

Puntero a una variable que recibe información adicional sobre el valor devuelto de la llamada de función.

Valor devuelto

Si la función se realiza correctamente, se STATUS_SUCCESS el valor devuelto.

Si se produce un error en la función, el valor devuelto es un código NTSTATUS que indica el motivo por el que se produjo un error.

Comentarios

Hay disponible un puntero a la función ConvertAuthDataToToKen en la estructura de LSA_SECPKG_FUNCTION_TABLE recibida por la función SpInitialize .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ntsecpkg.h