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
STATUS_INVALID_SECURITY_DESCR	Il descrittore di sicurezza specificato non è un descrittore di sicurezza assoluto valido. STATUS_INVALID_SECURITY_DESCR è un codice di errore.
STATUS_UNKNOWN_REVISION	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

Vedi anche

RtlGetGroupSecurityDescriptor

RtlSetOwnerSecurityDescriptor

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SID