Função SeAppendPrivileges (ntifs.h)

Artigo
02/07/2025

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.

Valor de retorno

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.

Observações

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 aloca um novo conjunto de privilégios do pool de páginas e copia 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.