Funzione RtlSetOwnerSecurityDescriptor (ntifs.h)

Articolo
02/26/2024

La routine RtlSetOwnerSecurityDescriptor imposta le informazioni del proprietario di un descrittore di sicurezza in formato assoluto. Sostituisce tutte le informazioni del proprietario già presenti nel descrittore di sicurezza.

Sintassi

NTSYSAPI NTSTATUS RtlSetOwnerSecurityDescriptor(
  [in, out]      PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in, optional] PSID                 Owner,
  [in, optional] BOOLEAN              OwnerDefaulted
);

Parametri

[in, out] SecurityDescriptor

Puntatore alla struttura SECURITY_DESCRIPTOR il cui proprietario deve essere impostato. RtlSetOwnerSecurityDescriptor sostituisce qualsiasi proprietario esistente con il nuovo proprietario.

[in, optional] Owner

Puntatore a una struttura SID (Security Identifier) per il nuovo proprietario primario del descrittore di sicurezza. Questo puntatore, non la struttura SID stessa, viene copiata nel descrittore di sicurezza. Se questo parametro è NULL, RtlSetOwnerSecurityDescriptor cancella le informazioni del proprietario del descrittore di sicurezza. Questo contrassegna il descrittore di sicurezza come senza proprietario.

[in, optional] OwnerDefaulted

Impostare su TRUE se le informazioni del proprietario sono derivate da un meccanismo predefinito. Se questo valore è TRUE, si tratta di informazioni predefinite. RtlSetOwnerSecurityDescriptor imposta il flag di SE_OWNER_DEFAULTED nel campo SECURITY_DESCRIPTOR_CONTROL del descrittore di sicurezza. Se questo parametro è FALSE, il flag di SE_OWNER_DEFAULTED viene cancellato.

Valore restituito

RtlSetOwnerSecurityDescriptor può restituire uno dei codici di stato seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Il proprietario è stato impostato o reimpostato correttamente.
STATUS_UNKNOWN_REVISION	La versione del descrittore di sicurezza specificata non viene riconosciuta da questa routine.
STATUS_INVALID_SECURITY_DESCR	Il descrittore di sicurezza specificato non è un descrittore di sicurezza assoluto valido.

Commenti

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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	ntifs.h (include Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe (modalità kernel); Ntdll.dll (modalità utente)
IRQL	< DISPATCH_LEVEL