Funzione RtlSetGroupSecurityDescriptor (ntifs.h)
La routine RtlSetGroupSecurityDescriptor imposta le informazioni di gruppo primarie di un descrittore di sicurezza in formato assoluto. Sostituisce tutte le informazioni del gruppo primarie 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 un identificatore di sicurezza (struttura SID) per il nuovo proprietario primario del descrittore di sicurezza. Questo puntatore, non la struttura SID stessa, viene copiato 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 SE_GROUP_DEFAULTED nel campo SECURITY_DESCRIPTOR_CONTROL del descrittore di sicurezza. Se questo parametro è FALSE, RtlSetGroupSecurityDescriptor cancella il flag 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. |
Osservazioni
Per recuperare le informazioni sul 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 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 (modalità kernel); Ntdll.dll (modalità utente) |
| IRQL | <= APC_LEVEL |