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

Artigo
02/29/2024

A função ConvertAuthDataToToken cria um token de acesso com base nos dados de autorização retornados das funções GetAuthDataForUser ou GetUserAuthData .

Sintaxe

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

Ponteiro para os dados de autorização recebidos das funções GetAuthDataForUser ou GetUserAuthData .

[in] UserAuthDataSize

Tamanho, em bytes, dos dados de autorização especificados pelo parâmetro UserAuthData .

[in] ImpersonationLevel

Um valor SECURITY_IMPERSONATION_LEVEL especificando o nível de representação para o token a ser criado.

[in] TokenSource

Ponteiro para uma estrutura TOKEN_SOURCE especificando a origem a ser registrada no token.

[in] LogonType

Um SECURITY_LOGON_TYPE valor que indica o tipo de logon a ser registrado no token.

[in] AuthorityName

Ponteiro para uma estrutura UNICODE_STRING que especifica o nome da autoridade que autorizou esse usuário, normalmente um nome de domínio.

[out] Token

Ponteiro para um HANDLE que recebe o identificador de token do usuário.

Quando terminar de usar o token de usuário, libere o identificador chamando CloseHandle.

[out] LogonId

Ponteiro para um LUID que recebe o identificador de logon para o token.

[out] AccountName

Ponteiro para uma estrutura UNICODE_STRING que recebe o nome da conta codificado no parâmetro UserAuthData .

[out] SubStatus

Ponteiro para uma variável que recebe informações adicionais sobre o valor retornado da chamada de função.

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

Um ponteiro para a função ConvertAuthDataToToken está disponível 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