Funzione RtlSetOwnerSecurityDescriptor (ntifs.h)

Articolo
02/07/2025

La routine RtlSetOwnerSecurityDescriptor imposta le informazioni sul proprietario di un descrittore di sicurezza in formato assoluto. Sostituisce tutte le informazioni sul 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 un identificatore di sicurezza (struttura SID) per il nuovo proprietario primario del descrittore di sicurezza. Questo puntatore, non la struttura SID stessa, viene copiato 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 sul 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.

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
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