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