Funzione GetSecurityDescriptorGroup (securitybaseapi.h)

Articolo
03/01/2024

La funzione GetSecurityDescriptorGroup recupera le informazioni sul gruppo primario da un descrittore di sicurezza.

Sintassi

BOOL GetSecurityDescriptorGroup(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] PSID                 *pGroup,
  [out] LPBOOL               lpbGroupDefaulted
);

Parametri

[in] pSecurityDescriptor

Puntatore a una struttura SECURITY_DESCRIPTOR di cui vengono recuperate le informazioni sul gruppo primario recuperate dalla funzione.

[out] pGroup

Puntatore a un puntatore a un IDENTIFICATORe di sicurezza (SID) che identifica il gruppo primario quando la funzione restituisce. Se il descrittore di sicurezza non contiene un gruppo primario, la funzione imposta il puntatore a cui fa riferimento pGroup su NULL e ignora il parametro di output rimanente , lpbGroupDefaulted. Se il descrittore di sicurezza contiene un gruppo primario, la funzione imposta il puntatore a cui punta pGroup sull'indirizzo del SID di gruppo del descrittore di sicurezza e fornisce un valore valido per la variabile a cui punta lpbGroupDefaulted.

[out] lpbGroupDefaulted

Puntatore a un flag impostato sul valore del flag SE_GROUP_DEFAULTED nella struttura SECURITY_DESCRIPTOR_CONTROL quando la funzione restituisce. Se il valore archiviato nella variabile a cui punta il parametro pGroup è NULL, non viene impostato alcun valore.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce 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