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 den Sicherheitsbezeichner (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 ohneNULL empfängt.
Rückgabewert
RtlGetGroupSecurityDescriptor gibt STATUS_SUCCESS oder einen entsprechenden 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. |
Bemerkungen
Wenn der sicherheitsdeskriptor, auf den SecurityDescriptor verweist eine primäre Gruppe enthält, legt RtlGetGroupSecurityDescriptor den Zeiger fest, auf den Group auf die Adresse der Gruppen-SID des Sicherheitsdeskriptors verweist, und legt die Variable fest, auf die GroupDefaulted- auf einen gültigen Wert verweist.
Wenn der sicherheitsdeskriptor, auf den SecurityDescriptor verweist, keine primäre Gruppe enthält, legt RtlGetGroupSecurityDescriptor den Zeiger, auf den Group verweist, auf NULL- und ignoriert den verbleibenden Ausgabeparameter, GroupDefaulted.
Um die primären Gruppeninformationen für einen Sicherheitsdeskriptor festzulegen, verwenden Sie RtlSetGroupSecurityDescriptor.
Um die Besitzerinformationen für einen Sicherheitsdeskriptor abzurufen, verwenden Sie RtlGetOwnerSecurityDescriptor.
Weitere Informationen zur Sicherheits- und Zugriffssteuerung finden Sie in der Microsoft Windows SDK-Dokumentation.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Server 2003 SP1 |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |
Siehe auch
RtlGetOwnerSecurityDescriptor-