SaferSetPolicyInformation-Funktion (winsafer.h)

  • Artikel

Die SaferSetPolicyInformation-Funktion legt die globalen Richtliniensteuerelemente fest.

Syntax

BOOL SaferSetPolicyInformation(
  [in] DWORD                   dwScopeId,
  [in] SAFER_POLICY_INFO_CLASS SaferPolicyInfoClass,
  [in] DWORD                   InfoBufferSize,
  [in] PVOID                   InfoBuffer,
       LPVOID                  lpReserved
);

Parameter

[in] dwScopeId

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

Wert Bedeutung
SAFER_SCOPEID_MACHINE
1
 Der Bereich der Abfrage ist nach Computer.
SAFER_SCOPEID_USER
2
 Der Bereich der Abfrage richtet sich nach Benutzer.

[in] SaferPolicyInfoClass

Ein SAFER_POLICY_INFO_CLASS Enumerationswert, der den Typ der festzulegenden Richtlinieninformationen angibt. Der angegebene Wert bestimmt die Größe und den Typ des InfoBuffer-Parameters . In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert Bedeutung
SaferPolicyLevelList
1
 Legt die Liste aller in einer Richtlinie definierten Ebenen fest.

InfoBuffer-Rückgabetyp : DWORD-Array von LevelIds.
SaferPolicyEnableTransparentEnforcement
2
 Legt den Richtlinienwert fest, um zu bestimmen, ob die DLL-Überprüfung aktiviert ist.

InfoBuffer-Rückgabetyp : DWORD Boolean.
SaferPolicyDefaultLevel
3
 Legt die Standardrichtlinienebene fest.

InfoBuffer-Rückgabetyp : DWORD LevelId.
SaferPolicyEvaluateUserScope
4
 Legt fest, ob Benutzerbereichsregeln während der Richtlinienauswertung konsultiert werden sollen.

InfoBuffer-Rückgabetyp : DWORD.
SaferPolicyScopeFlags
5
 Legt fest, ob die Richtlinie Mitglieder der lokalen Administratorgruppe überspringen soll.

InfoBuffer-Rückgabetyp : DWORD.

[in] InfoBufferSize

Die Größe des InfoBuffer-Parameters in Bytes.

[in] InfoBuffer

Ein Puffer, der die Ergebnisse der Abfrage enthält. Die Größe und der Typ der zurückgegebenen Informationen werden durch den Parameter SaferPolicyInfoClass bestimmt. Den Typ der zurückgegebenen Informationen für jeden möglichen Wert des SaferPolicyInfoClass-Parameters finden Sie im SaferPolicyInfoClass-Parameter .

lpReserved

Für die zukünftige Verwendung reserviert. Dieser Parameter sollte auf NULL festgelegt werden.

Rückgabewert

TRUE , wenn die Funktion erfolgreich ist; andernfalls FALSE. 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)