Funzione RtlGetGroupSecurityDescriptor (ntifs.h)
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 |
|---|---|
|
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 |