Funzione RtlGetSaclSecurityDescriptor (ntifs.h)

Articolo
02/07/2025

La routine RtlGetSaclSecurityDescriptor restituisce un puntatore all'ACL di sistema (SACL) per un descrittore di sicurezza.

Sintassi

NTSYSAPI NTSTATUS RtlGetSaclSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PBOOLEAN             SaclPresent,
  [out] PACL                 *Sacl,
  [out] PBOOLEAN             SaclDefaulted
);

Parametri

[in] SecurityDescriptor

Puntatore al SECURITY_DESCRIPTOR il cui sacl deve essere restituito.

[out] SaclPresent

Puntatore a una variabile booleana che indica la presenza di un oggetto SACL nel descrittore di sicurezza specificato. Se questa variabile riceve TRUE, il descrittore di sicurezza contiene un oggetto SACL e i parametri di output rimanenti ricevono valori validi. Se questa variabile riceve FALSE, il descrittore di sicurezza non contiene un oggetto SACL e i parametri di output rimanenti non ricevono valori validi.

[out] Sacl

Puntatore a una variabile che riceve l'indirizzo di SACL per il descrittore di sicurezza. Se il descrittore di sicurezza non dispone di un sacl, questa variabile non riceve un valore. Se il descrittore di sicurezza dispone di un NULL SACL, questa variabile riceve NULL.

[out] SaclDefaulted

Puntatore a una variabile booleana che riceve il valore del flag di SE_SACL_DEFAULTED nella struttura di SECURITY_DESCRIPTOR_CONTROL del descrittore di sicurezza se è presente un oggetto SACL per il descrittore di sicurezza.

Valore restituito

RtlGetSaclSecurityDescriptor restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio:

Codice restituito	Descrizione
STATUS_UNKNOWN_REVISION	Il livello di revisione del descrittore di sicurezza è sconosciuto o non è supportato. Si tratta di un codice di errore.

Osservazioni

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Server 2003 SP1
piattaforma di destinazione	Universale
intestazione	ntifs.h (include Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	<= APC_LEVEL