Funzione RtlSetGroupSecurityDescriptor (ntifs.h)
La routine RtlSetGroupSecurityDescriptor imposta le informazioni del gruppo primario di un descrittore di sicurezza in formato assoluto. Sostituisce tutte le informazioni del gruppo primario già presenti nel descrittore di sicurezza.
Sintassi
NTSYSAPI NTSTATUS RtlSetGroupSecurityDescriptor(
[in, out] PSECURITY_DESCRIPTOR SecurityDescriptor,
[in, optional] PSID Group,
[in, optional] BOOLEAN GroupDefaulted
);
Parametri
[in, out] SecurityDescriptor
Puntatore alla struttura SECURITY_DESCRIPTOR il cui gruppo primario deve essere impostato. RtlSetGroupSecurityDescriptor sostituisce qualsiasi gruppo primario esistente con il nuovo gruppo primario.
[in, optional] Group
Puntatore a una struttura SID (Security Identifier) per il nuovo proprietario primario del descrittore di sicurezza. Questo puntatore, non la struttura SID stessa, viene copiata nel descrittore di sicurezza. Se Group è NULL, RtlSetGroupSecurityDescriptor cancella le informazioni del gruppo primario del descrittore di sicurezza. Questo contrassegna il descrittore di sicurezza come senza gruppo primario.
[in, optional] GroupDefaulted
Impostare questa variabile booleana su TRUE se le informazioni del gruppo primario sono derivate da un meccanismo predefinito. Se questo parametro è TRUE, RtlSetGroupSecurityDescriptor imposta il flag di SE_GROUP_DEFAULTED nel campo SECURITY_DESCRIPTOR_CONTROL del descrittore di sicurezza. Se questo parametro è FALSE, RtlSetGroupSecurityDescriptor cancella il flag di SE_GROUP_DEFAULTED.
Valore restituito
RtlSetGroupSecurityDescriptor restituisce STATUS_SUCCESS se il gruppo primario è stato impostato o reimpostato correttamente. In caso contrario, restituisce un valore NTSTATUS appropriato, ad esempio uno dei seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Il descrittore di sicurezza specificato non è un descrittore di sicurezza assoluto valido. STATUS_INVALID_SECURITY_DESCR è un codice di errore. |
|
La revisione del descrittore di sicurezza specificata non viene riconosciuta da questa routine. STATUS_UNKNOWN_REVISION è un codice di errore. |
Commenti
Per recuperare le informazioni del gruppo primario per un descrittore di sicurezza, usare RtlGetGroupSecurityDescriptor.
Per impostare le informazioni sul proprietario per un descrittore di sicurezza, usare RtlSetOwnerSecurityDescriptor.
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 (modalità kernel); Ntdll.dll (modalità utente) |
| IRQL | <= APC_LEVEL |