Funzione RtlGetGroupSecurityDescriptor (ntifs.h)

  • Articolo

La routine RtlGetGroupSecurityDescriptor restituisce le informazioni di gruppo primarie per un descrittore di sicurezza specificato.

Sintassi

NTSYSAPI NTSTATUS RtlGetGroupSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PSID                 *Group,
  [out] PBOOLEAN             GroupDefaulted
);

Parametri

[in] SecurityDescriptor

Puntatore al descrittore di sicurezza le cui informazioni di gruppo primarie devono essere restituite.

[out] Group

Puntatore a una variabile che riceve un puntatore all'identificatore di sicurezza (SID) per il gruppo primario. Se il descrittore di sicurezza non contiene un gruppo primario, *Group riceve NULL.

[out] GroupDefaulted

Puntatore a una variabile booleana che riceve il valore del flag di SE_GROUP_DEFAULTED nella struttura di SECURITY_DESCRIPTOR_CONTROL del descrittore di sicurezza. Questo valore è valido solo se *Group riceve un valore non NULL .

Valore restituito

RtlGetGroupSecurityDescriptor restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio quanto segue:

Codice restituito Descrizione
STATUS_UNKNOWN_REVISION
 Il livello di revisione del descrittore di sicurezza non è noto o non è supportato. Si tratta di un codice di errore.

Commenti

Se il descrittore di sicurezza puntato da SecurityDescriptor contiene un gruppo primario, RtlGetGroupSecurityDescriptor imposta il puntatore puntato a da Group all'indirizzo del SID del descrittore di sicurezza e imposta la variabile puntata a da GroupDefaulted a un valore valido.

Se il descrittore di sicurezza puntato da SecurityDescriptor non contiene un gruppo primario, RtlGetGroupSecurityDescriptor imposta il puntatore puntato a da Group a NULL e ignora il parametro di output rimanente, GroupDefaulted.

Per impostare le informazioni del gruppo primario per un descrittore di sicurezza, usare RtlSetGroupSecurityDescriptor.

Per recuperare le informazioni sul proprietario per un descrittore di sicurezza, usare RtlGetOwnerSecurityDescriptor.

Per altre informazioni sul controllo di sicurezza e accesso, vedere la documentazione di Microsoft Windows SDK.

Requisiti

Requisito Valore
Client minimo supportato Windows Server 2003 SP1
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Vedi anche

RtlGetOwnerSecurityDescriptor

RtlSetGroupSecurityDescriptor

SECURITY_DESCRIPTOR

SID