Condividi tramite


Funzione SetSecurityDescriptorGroup (securitybaseapi.h)

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

Vedi anche

GetSecurityDescriptorGroup

InitializeSecurityDescriptor

Controllo di accesso di basso livello

Funzioni di Controllo di accesso di basso livello

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SID

SetSecurityDescriptorDacl

SetSecurityDescriptorOwner

SetSecurityDescriptorSacl