SaferCreateLevel-Funktion (winsafer.h)

  • Artikel

Die SaferCreateLevel-Funktion öffnet eine SAFER_LEVEL_HANDLE.

Syntax

BOOL SaferCreateLevel(
  [in]  DWORD              dwScopeId,
  [in]  DWORD              dwLevelId,
  [in]  DWORD              OpenFlags,
  [out] SAFER_LEVEL_HANDLE *pLevelHandle,
        LPVOID             lpReserved
);

Parameter

[in] dwScopeId

Der Bereich der zu erstellenden Ebene. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert Bedeutung
SAFER_SCOPEID_MACHINE
1
 Der Bereich der erstellten Ebene erfolgt nach Computer.
SAFER_SCOPEID_USER
2
 Der Bereich der erstellten Ebene richtet sich nach Benutzer.

[in] dwLevelId

Die Ebene des zu öffnenden Handles. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert Bedeutung
SAFER_LEVELID_CONSTRAINED
0x10000
 Software kann unabhängig von den Benutzerrechten des Benutzers nicht auf bestimmte Ressourcen zugreifen, z. B. kryptografische Schlüssel und Anmeldeinformationen.
SAFER_LEVELID_DISALLOWED
0x00000
 Software wird nicht ausgeführt, unabhängig von den Benutzerrechten des Benutzers.
SAFER_LEVELID_FULLYTRUSTED
0x40000
 Softwarebenutzerrechte werden durch die Benutzerrechte des Benutzers bestimmt.
SAFER_LEVELID_NORMALUSER
0x20000
 Ermöglicht die Ausführung von Programmen als Benutzer ohne Administrator - oder Power User-Benutzerrechte . Software kann auf Ressourcen zugreifen, auf die normale Benutzer zugreifen können.
SAFER_LEVELID_UNTRUSTED
0x01000
 Ermöglicht die Ausführung von Programmen nur mit Zugriff auf Ressourcen, die zum Öffnen bekannter Gruppen gewährt werden, und blockiert den Zugriff auf Administrator - und Power User-Berechtigungen und persönliche Rechte.

[in] OpenFlags

Dies kann der folgende Wert sein.

Wert Bedeutung
SAFER_LEVEL_OPEN
1

[out] pLevelHandle

Der zurückgegebene SAFER_LEVEL_HANDLE. Wenn Sie mit der Verwendung des Handles fertig sind, schließen Sie es, indem Sie die SaferCloseLevel-Funktion aufrufen.

lpReserved

Dieser Parameter ist für die zukünftige Verwendung reserviert. Legen Sie sie auf NULL fest.

Rückgabewert

Gibt nonzero zurück, wenn der Vorgang erfolgreich war oder andernfalls null.

Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winsafer.h
Bibliothek Advapi32.lib
DLL Advapi32.dll
APIs ext-ms-win-advapi32-safer-l1-1-0 (eingeführt in Windows 8)