LSA_GET_AUTH_DATA_FOR_USER função de retorno de chamada (ntsecpkg.h)

Artigo
02/29/2024

A função GetAuthDataForUser recupera informações de autenticação de um usuário do banco de dados SAM (Gerenciador de Contas de Segurança) e as coloca em um formato adequado para a função ConvertAuthDataToToken .

Sintaxe

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

Ponteiro para uma estrutura UNICODE_STRING que especifica o nome da conta SAM.

[in] NameType

Um SECPKG_NAME_TYPE valor de enumeração que especifica o tipo de nome da conta em Nome. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
SecNameSamCompatible	O nome é compatível com o SAM. Um exemplo de um nome no formato compatível com SAM é "ExampleDomain\Username".
SecNameAlternateId	Name está na propriedade AltSecId da conta SAM. Você deve especificar um valor para o parâmetro Prefix ao usar esse valor.
SecNameFlat	Nome é um nome de conta de estilo UPN ( nome upn ) simples.
SecNameDN	Name é o nome diferenciado do objeto. Para obter mais informações, consulte Comentários.

[in] Prefix

Ponteiro para uma estrutura UNICODE_STRING que contém o prefixo a ser usado para nomes especificados com SecNameAlternateIdNameType.

[out] UserAuthData

Ponteiro que recebe o endereço dos dados recuperados.

[out] UserAuthDataSize

Ponteiro para um ULONG que recebe o tamanho dos dados recuperados.

[out] UserFlatName

Ponteiro para uma estrutura UNICODE_STRING que recebe o UPN, se aplicável.

Retornar valor

Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.

Se a função falhar, o valor retornado será um código NTSTATUS que indica o motivo pelo qual ela falhou.

Comentários

A função GetAuthDataForUser combina as funções OpenSamUser, GetUserAuthData e CloseSamUser em uma chamada.

Os ponteiros para essas funções estão disponíveis na estrutura LSA_SECPKG_FUNCTION_TABLE recebida pela função SpInitialize .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ntsecpkg.h