LSA_GET_AUTH_DATA_FOR_USER função de retorno de chamada (ntsecpkg.h)
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 |
---|---|
|
O nome é compatível com o SAM. Um exemplo de um nome no formato compatível com SAM é "ExampleDomain\Username". |
|
Name está na propriedade AltSecId da conta SAM. Você deve especificar um valor para o parâmetro Prefix ao usar esse valor. |
|
Nome é um nome de conta de estilo UPN ( nome upn ) simples. |
|
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 |