Compartilhar via


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

Cria tokens ao processar chamadas para SpAcceptLsaModeContext.

Sintaxe

LSA_CREATE_TOKEN_EX LsaCreateTokenEx;

NTSTATUS LsaCreateTokenEx(
  [in]  PLUID LogonId,
  [in]  PTOKEN_SOURCE TokenSource,
  [in]  SECURITY_LOGON_TYPE LogonType,
  [in]  SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]  LSA_TOKEN_INFORMATION_TYPE TokenInformationType,
  [in]  PVOID TokenInformation,
  [in]  PTOKEN_GROUPS TokenGroups,
  [in]  PUNICODE_STRING Workstation,
  [in]  PUNICODE_STRING ProfilePath,
  [in]  PVOID SessionInformation,
  [in]  SECPKG_SESSIONINFO_TYPE SessionInformationType,
  [out] PHANDLE Token,
  [out] PNTSTATUS SubStatus
)
{...}

Parâmetros

[in] LogonId

Um ponteiro para um identificador de sessão de logon para o novo token. Esse identificador é obtido de uma chamada anterior para CreateLogonSession.

[in] TokenSource

Um ponteiro para uma estrutura de TOKEN_SOURCE que especifica a origem desse token. Especifique o nome do pacote.

[in] LogonType

Um valor SECURITY_LOGON_TYPE que indica o tipo de logon.

[in] ImpersonationLevel

Um valor SECURITY_IMPERSONATION_LEVEL que indica até que ponto um processo de servidor pode representar um processo de cliente.

[in] TokenInformationType

Especifica o tipo de estrutura no parâmetro TokenInformation .

Valor Significado
LsaTokenInformationNull

LSA_TOKEN_INFORMATION_NULL

LsaTokenInformationV1

LSA_TOKEN_INFORMATION_V1

[in] TokenInformation

Um ponteiro para as informações do token. O tipo de estrutura apontado por TokenInformation é indicado pelo parâmetro TokenInformationType .

[in] TokenGroups

Um ponteiro para uma estrutura de TOKEN_GROUPS que especifica grupos não contidos em TokenInformation.

[in] Workstation

Um ponteiro para uma estrutura UNICODE_STRING que contém o nome da estação de trabalho do cliente, normalmente um nome NetBIOS.

[in] ProfilePath

Um ponteiro para uma estrutura UNICODE_STRING que contém o caminho para o perfil do usuário, se houver.

[in] SessionInformation

Dados que especificam informações sobre a sessão de logon atual. O formato desses dados é especificado pelo valor do parâmetro SessionInformationType .

[in] SessionInformationType

Um valor da enumeração SECPKG_SESSIONINFO_TYPE que especifica o formato do parâmetro SessionInformation . Atualmente, o único valor definido é SecSessionPrimaryCred, que especifica que o valor do parâmetro SessionInformation é uma estrutura SECPKG_PRIMARY_CRED .

[out] Token

Um ponteiro que recebe o endereço de um identificador para o novo token. Quando terminar de usar o identificador, feche-o chamando a função CloseHandle .

[out] SubStatus

Um ponteiro para uma variável que recebe informações de erro.

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 CreateTokenEx 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

Confira também

SpInitialize