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

Artículo
03/09/2024

La función GetAuthDataForUser recupera la información de autenticación de un usuario de la base de datos administrador de cuentas de seguridad (SAM) y la coloca en un formato adecuado para la función ConvertAuthDataToToken .

Sintaxis

LSA_GET_AUTH_DATA_FOR_USER LsaGetAuthDataForUser;

NTSTATUS LsaGetAuthDataForUser(
  [in]  PSECURITY_STRING Name,
  [in]  SECPKG_NAME_TYPE NameType,
  [in]  PSECURITY_STRING Prefix,
  [out] PUCHAR *UserAuthData,
  [out] PULONG UserAuthDataSize,
  [out] PUNICODE_STRING UserFlatName
)
{...}

Parámetros

[in] Name

Puntero a una estructura de UNICODE_STRING que especifica el nombre de la cuenta SAM.

[in] NameType

Valor de enumeración SECPKG_NAME_TYPE que especifica el tipo de nombre de cuenta en Nombre. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
SecNameSamCompatible	El nombre es compatible con sam. Un ejemplo de un nombre en formato compatible con SAM es "ExampleDomain\Username".
SecNameAlternateId	Name se encuentra en la propiedad AltSecId de la cuenta SAM. Debe especificar un valor para el parámetro Prefix al usar este valor.
SecNameFlat	El nombre es un nombre de cuenta de estilo de nombre principal de usuario plano (UPN).
SecNameDN	Name es el nombre distintivo del objeto. Para obtener más información, vea la sección Comentarios.

[in] Prefix

Puntero a una estructura de UNICODE_STRING que contiene el prefijo que se va a usar para los nombres especificados con secNameAlternateIdNameType.

[out] UserAuthData

Puntero que recibe la dirección de los datos recuperados.

[out] UserAuthDataSize

Puntero a un ULONG que recibe el tamaño de los datos recuperados.

[out] UserFlatName

Puntero a una estructura de UNICODE_STRING que recibe el UPN, si procede.

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

La función GetAuthDataForUser combina las funciones OpenSamUser, GetUserAuthData y CloseSamUser en una llamada.

Los punteros a estas funciones están disponibles en la estructura 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