Funzione RtlCreateSecurityDescriptorRelative (ntifs.h)

Articolo
02/07/2025

La routine RtlCreateSecurityDescriptorRelative inizializza un nuovo descrittore di sicurezza in formato auto-relativo. In caso di restituzione, il descrittore di sicurezza viene inizializzato senza ACL di sistema (SACL), nessun ACL discrezionale (DACL), nessun proprietario, nessun gruppo primario e tutti i flag di controllo impostati su zero.

Sintassi

NTSYSAPI NTSTATUS RtlCreateSecurityDescriptorRelative(
  [out] PISECURITY_DESCRIPTOR_RELATIVE SecurityDescriptor,
  [in]  ULONG                          Revision
);

Parametri

[out] SecurityDescriptor

Puntatore a un buffer allocato dal chiamante, che deve essere almeno sizeof(SECURITY_DESCRIPTOR_RELATIVE), per ricevere il descrittore di sicurezza inizializzato.

[in] Revision

Livello di revisione da assegnare al descrittore di sicurezza. Questo parametro deve essere SECURITY_DESCRIPTOR_REVISION.

Valore restituito

RtlCreateSecurityDescriptorRelative può restituire uno dei seguenti elementi:

Codice restituito	Descrizione
STATUS_SUCCESS	La chiamata è stata completata correttamente.
STATUS_UNKNOWN_REVISION	Il di revisione specificato non è noto o non è supportato.

Osservazioni

In effetti, una chiamata riuscita a questa routine inizializza un descrittore di sicurezza senza vincoli di sicurezza.

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 2000
piattaforma di destinazione	Desktop
intestazione	ntifs.h (include Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL