Funzione RtlCreateSecurityDescriptorRelative (ntifs.h)

Articolo
02/27/2024

La routine RtlCreateSecurityDescriptorRelative inizializza un nuovo descrittore di sicurezza in formato auto-relativo. In cambio, 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 una delle opzioni seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La chiamata è stata completata correttamente.
STATUS_UNKNOWN_REVISION	La revisione specificata non è nota o non è supportata.

Commenti

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.

Requisiti

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