Funzione RtlGetGroupSecurityDescriptor (ntifs.h)
La routine RtlGetGroupSecurityDescriptor restituisce le informazioni sui gruppi primari 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 sul gruppo primario 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 SE_GROUP_DEFAULTED nella struttura di SECURITY_DESCRIPTOR_CONTROL del descrittore di sicurezza. Questo valore è valido solo se *Group riceve un valoreNULL non.
Valore restituito
RtlGetGroupSecurityDescriptor restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio il seguente:
| Codice restituito | Descrizione |
|---|---|
|
Il livello di revisione del descrittore di sicurezza non è noto o non è supportato. Si tratta di un codice di errore. |
Osservazioni
Se il descrittore di sicurezza a cui punta SecurityDescriptor contiene un gruppo primario, RtlGetGroupSecurityDescriptor imposta il puntatore a cui punta Group all'indirizzo del SID del descrittore di sicurezza e imposta la variabile a cui punta GroupDefaulted su un valore valido.
Se il descrittore di sicurezza a cui punta securityDescriptor non contiene un gruppo primario, RtlGetGroupSecurityDescriptor imposta il puntatore a cui punta Group su NULL e ignora il parametro di output rimanente, GroupDefaulted.
Per impostare le informazioni sui gruppi primari per un descrittore di sicurezza, usare RtlSetGroupSecurityDescriptor.
Per recuperare le informazioni sul proprietario per un descrittore di sicurezza, usare RtlGetOwnerSecurityDescriptor.
Per altre informazioni sulla sicurezza e sul controllo di accesso, vedere la documentazione di Microsoft Windows SDK.
Fabbisogno
| 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 |