Compartilhar via


Função NtCreateLowBoxToken

A função NtCreateLowBoxToken cria um objeto de token LowBox (AppContainer) com base em um token de acesso existente e retorna o identificador aberto para acesso a esse token.

Sintaxe

NTSTATUS NTAPI NtCreateLowBoxToken(
  _Out_ PHANDLE             TokenHandle,
  _In_  HANDLE              ExistingTokenHandle,
  _In_  ACCESS_MASK         DesiredAccess,
  _in_  POBJECT_ATTRIBUTES  ObjectAttributes,
  _in_  PSID                PackageSid,
  _in_  ULONG               CapabilityCount,
  _in_  PSID_AND_ATTRIBUTES Capabilities,
  _in_  ULONG               HandleCount,
  _in_  HANDLE*             Handles
);

Parâmetros

TokenHandle [out]

Retorna o identificador do token LowBox recém-criado.

ExistingTokenHandle [in]

O identificador do token criado existente. O token deve estar aberto para acesso TOKEN_QUERY .

DesiredAccess [in]

Um ACCESS_MASK indicando quais tipos de acesso o identificador deve fornecer ao novo objeto.

ObjectAttributes [in, Optional]

Aponta para a estrutura de dados de OBJECT_ATTRIBUTES padrão.

PackageSid [in]

O pacote ao qual esse token pertencerá. Isso deve apontar para um SID válido que deve ser um membro do grupo SID do Pacote LowBox.

CapabilityCount [in]

O número de recursos a serem incluídos no token.

Capabilities [in, Optional]

A estrutura SID_AND_ATTRIBUTES que contém os SIDs de capacidade a serem incluídos no token.

HandleCount [in]

O número de identificadores a serem incluídos no token.

Handles [in, Optional]

Manipula os diretórios de objeto nomeados para o AppContainer.

Retornar valor

Se a função for bem-sucedida, a função retornará STATUS_SUCCESS.

Se a função falhar, ela retornará um código de erro NTSTATUS . Consulte valores NTSTATUS para obter uma lista de códigos de erro e seus valores.

Comentários

Essa API só pode ser chamada por processo il médio ou superior.

Essa função não tem biblioteca de importação ou arquivo de cabeçalho associado; você deve chamá-lo usando as funções LoadLibrary e GetProcAddress .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
DLL Ntdll.dll

Confira também

NtCompareTokens