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 |
|---|---|
|
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 |