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 |