GetSecurityDescriptorRMControl-Funktion (securitybaseapi.h)

Die GetSecurityDescriptorRMControl-Funktion ruft die Ressourcen-Manager-Steuerelementbits ab.

Syntax

DWORD GetSecurityDescriptorRMControl(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PUCHAR               RMControl
);

Parameter

[in] SecurityDescriptor

Ein Zeiger auf eine SECURITY_DESCRIPTOR-Struktur , die die Ressourcen-Manager-Steuerelementbits enthält. Der Wert des Steuerelementelements ist auf SE_RM_CONTROL_VALID festgelegt.

[out] RMControl

Ein Zeiger auf einen Puffer, der die Ressourcen-Manager-Steuerelementbits empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, wird der folgende Wert zurückgegeben.

Rückgabecode Beschreibung
ERROR_INVALID_DATA
Das SE_RM_CONTROL_VALID Bitflag ist in der angegebenen SECURITY_DESCRIPTOR-Struktur nicht festgelegt.

Hinweise

Die Ressourcen-Manager-Steuerungsbits sind acht Bits im Sbz1-Member der SECURITY_DESCRIPTOR-Struktur , die spezifische Informationen für den Ressourcen-Manager enthält, der auf die Struktur zugreift. Auf diese Bits sollte nur über die Funktionen GetSecurityDescriptorRMControl und SetSecurityDescriptorRMControl zugegriffen werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile securitybaseapi.h (einschließlich Windows.h)
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

Zugriffssteuerung Übersicht

Grundlegende Access Control-Funktionen

SECURITY_DESCRIPTOR

SetSecurityDescriptorRMControl