RtlGetGroupSecurityDescriptor-Funktion (ntifs.h)

Die RtlGetGroupSecurityDescriptor-Routine gibt die Primären Gruppeninformationen für einen bestimmten Sicherheitsdeskriptor zurück.

Syntax

NTSYSAPI NTSTATUS RtlGetGroupSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PSID                 *Group,
  [out] PBOOLEAN             GroupDefaulted
);

Parameter

[in] SecurityDescriptor

Zeiger auf den Sicherheitsdeskriptor, dessen primäre Gruppeninformationen zurückgegeben werden sollen.

[out] Group

Zeiger auf eine Variable, die einen Zeiger auf die Sicherheits-ID (SID) für die primäre Gruppe empfängt. Wenn der Sicherheitsdeskriptor keine primäre Gruppe enthält, empfängt *GroupNULL.

[out] GroupDefaulted

Zeiger auf eine boolesche Variable, die den Wert des SE_GROUP_DEFAULTED-Flags in der SECURITY_DESCRIPTOR_CONTROL-Struktur des Sicherheitsdeskriptors empfängt. Dieser Wert ist nur gültig, wenn *Group einen Wert ungleich NULL empfängt.

Rückgabewert

RtlGetGroupSecurityDescriptor gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert wie den folgenden zurück:

Rückgabecode	Beschreibung
STATUS_UNKNOWN_REVISION	Die Revisionsebene des Sicherheitsdeskriptors ist nicht bekannt oder wird nicht unterstützt. Dies ist ein Fehlercode.

Hinweise

Wenn der Sicherheitsdeskriptor, auf den von SecurityDescriptor verwiesen wird, eine primäre Gruppe enthält, legt RtlGetGroupSecurityDescriptor den Zeiger, auf den Group zeigt, auf die Adresse der Gruppen-SID des Sicherheitsdeskriptors fest und legt die Variable, auf die groupDefaulted zeigt, auf einen gültigen Wert fest.

Wenn der Sicherheitsdeskriptor, auf den securityDescriptor verweist, keine primäre Gruppe enthält, legt RtlGetGroupSecurityDescriptor den Zeiger, auf den Group zeigt, auf NULL fest und ignoriert den verbleibenden Ausgabeparameter GroupDefaulted.

Verwenden Sie RtlSetGroupSecurityDescriptor, um die Informationen der primären Gruppe für einen Sicherheitsdeskriptor festzulegen.

Verwenden Sie RtlGetOwnerSecurityDescriptor, um die Besitzerinformationen für einen Sicherheitsdeskriptor abzurufen.

Weitere Informationen zur Sicherheit und Zugriffssteuerung finden Sie in der Microsoft Windows SDK-Dokumentation.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Server 2003 SP1
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Weitere Informationen

RtlGetOwnerSecurityDescriptor

RtlSetGroupSecurityDescriptor

SECURITY_DESCRIPTOR

SID