Compartilhar via


Função SeAppendPrivileges (ntifs.h)

A rotina SeAppendPrivileges acrescenta privilégios adicionais ao conjunto de privilégios em uma estrutura de estado de acesso.

Sintaxe

NTSTATUS SeAppendPrivileges(
  [in, out] PACCESS_STATE  AccessState,
  [in]      PPRIVILEGE_SET Privileges
);

Parâmetros

[in, out] AccessState

Ponteiro para uma estrutura de ACCESS_STATE alocada pelo chamador que representa a solicitação de acesso atual.

[in] Privileges

Ponteiro para uma estrutura de PRIVILEGE_SET alocada pelo chamador que contém os privilégios a serem adicionados.

Retornar valor

Código de retorno Descrição
STATUS_SUCCESS
A operação de acréscimo foi bem-sucedida.
STATUS_INSUFFICIENT_RESOURCES
SeAppendPrivileges encontrou uma falha de alocação de pool ao alocar memória para os novos privilégios.

Comentários

Inicialmente, uma estrutura de estado de acesso pode conter até três privilégios em seu conjunto de privilégios. Se mais de três privilégios precisarem ser armazenados, SeAppendPrivileges alocará um novo conjunto de privilégios do pool de páginas e copiará para ele os privilégios atuais e os novos privilégios.

Para obter mais informações sobre segurança e controle de acesso, consulte Modelo de segurança do Windows para desenvolvedores de driver e a documentação sobre esses tópicos no SDK do Windows.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Confira também

ACCESS_STATE

PRIVILEGE_SET

SeAccessCheck

SeFreePrivileges

SePrivilegeCheck

SeSetAccessStateGenericMapping