Funzione SeAppendPrivileges (ntifs.h)

Articolo
02/29/2024

La routine SeAppendPrivileges aggiunge privilegi aggiuntivi al privilegio impostato in una struttura dello stato di accesso.

Sintassi

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

Parametri

[in, out] AccessState

Puntatore a una struttura di ACCESS_STATE allocata dal chiamante che rappresenta la richiesta di accesso corrente.

[in] Privileges

Puntatore a una struttura di PRIVILEGE_SET allocata dal chiamante contenente i privilegi da aggiungere.

Valore restituito

Codice restituito	Descrizione
STATUS_SUCCESS	Operazione di accodamento riuscita.
STATUS_INSUFFICIENT_RESOURCES	SeAppendPrivileges ha rilevato un errore di allocazione del pool durante l'allocazione della memoria per i nuovi privilegi.

Commenti

Inizialmente, una struttura dello stato di accesso può contenere fino a tre privilegi nel relativo set di privilegi. Se è necessario archiviare più di tre privilegi, SeAppendPrivileges alloca un nuovo set di privilegi dal pool di pagine e copia in esso sia i privilegi correnti che i nuovi privilegi.

Per altre informazioni sul controllo di sicurezza e accesso, vedere Modello di sicurezza di Windows per sviluppatori driver e la documentazione su questi argomenti in Windows SDK.