Funzione SetSecurityDescriptorGroup (securitybaseapi.h)

Articolo
03/15/2023

La funzione SetSecurityDescriptorGroup imposta le informazioni sul gruppo primarie di un descrittore di sicurezza in formato assoluto, sostituendo eventuali informazioni sul gruppo primario già presenti nel descrittore di sicurezza.

Sintassi

BOOL SetSecurityDescriptorGroup(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pGroup,
  [in]           BOOL                 bGroupDefaulted
);

Parametri

[in, out] pSecurityDescriptor

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

[in, optional] pGroup

Puntatore a una struttura SID per il nuovo gruppo primario del descrittore di sicurezza. Alla struttura SID viene fatto riferimento, non copiato, nel descrittore di sicurezza. Se questo parametro è NULL, la funzione cancella le informazioni sul gruppo primario del descrittore di sicurezza. Questo contrassegna il descrittore di sicurezza come senza gruppo primario.

[in] bGroupDefaulted

Indica se le informazioni sul gruppo primario sono state derivate da un meccanismo predefinito. Se questo valore è TRUE, si tratta di informazioni predefinite e la funzione archivia questo valore come flag SE_GROUP_DEFAULTED nella struttura SECURITY_DESCRIPTOR_CONTROL . Se questo parametro è zero, il flag SE_GROUP_DEFAULTED viene cancellato.

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

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