Funzione SetSecurityDescriptorOwner (securitybaseapi.h)

Articolo
03/15/2023

La funzione SetSecurityDescriptorOwner 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

BOOL SetSecurityDescriptorOwner(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pOwner,
  [in]           BOOL                 bOwnerDefaulted
);

Parametri

[in, out] pSecurityDescriptor

Puntatore alla struttura SECURITY_DESCRIPTOR il cui proprietario è impostato da questa funzione. La funzione sostituisce qualsiasi proprietario esistente con il nuovo proprietario.

[in, optional] pOwner

Puntatore a una struttura SID per il nuovo proprietario primario del descrittore di sicurezza. La struttura SID viene a cui fa riferimento, non copiato, il descrittore di sicurezza. Se questo parametro è NULL, la funzione cancella le informazioni del proprietario del descrittore di sicurezza. Questo contrassegna il descrittore di sicurezza come senza proprietario.

[in] bOwnerDefaulted

Indica se le informazioni del proprietario sono derivate da un meccanismo predefinito. Se questo valore è TRUE, si tratta di informazioni predefinite. La funzione archivia questo valore come flag di SE_OWNER_DEFAULTED nella struttura SECURITY_DESCRIPTOR_CONTROL . Se questo parametro è zero, il flag di SE_OWNER_DEFAULTED viene deselezionato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti


Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	securitybaseapi.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll