Freigeben über

SaferGetPolicyInformation-Funktion (winsafer.h)

  • Artikel

Die SaferGetPolicyInformation-Funktion ruft Informationen zu einer Richtlinie ab. Sie können abfragen, um weitere Informationen zur Richtlinie zu erhalten.

Syntax

BOOL SaferGetPolicyInformation(
  [in]  DWORD                   dwScopeId,
  [in]  SAFER_POLICY_INFO_CLASS SaferPolicyInfoClass,
  [in]  DWORD                   InfoBufferSize,
  [out] PVOID                   InfoBuffer,
  [out] PDWORD                  InfoBufferRetSize,
        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 zurückgegebenen 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
 Abfragen für die Liste aller in einer Richtlinie definierten Ebenen.

InfoBuffer-Rückgabetyp : DWORD-Array von LevelIds.
SaferPolicyEnableTransparentEnforcement
2
 Fragt nach dem Richtlinienwert ab, um zu bestimmen, ob die DLL-Überprüfung aktiviert ist.

InfoBuffer-Rückgabetyp : DWORD Boolean.
SaferPolicyDefaultLevel
3
 Abfragen für die Standardrichtlinienebene.

InfoBuffer-Rückgabetyp : DWORD LevelId.
SaferPolicyEvaluateUserScope
4
 Abfragen, um zu ermitteln, ob Benutzerbereichsregeln während der Richtlinienauswertung konsultiert werden sollen.

InfoBuffer-Rückgabetyp : DWORD.
SaferPolicyScopeFlags
5
 Abfragen, um zu bestimmen, ob die Richtlinie Mitglieder der lokalen Administratorgruppe überspringen soll.

InfoBuffer-Rückgabetyp : DWORD.

[in] InfoBufferSize

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

[out] 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 .

[out] InfoBufferRetSize

Die Anzahl der Bytes im InfoBuffer-Parameter , die mit Richtlinieninformationen gefüllt wurden.

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

   
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)