SaferGetLevelInformation-Funktion (winsafer.h)

  • Artikel

Die SaferGetLevelInformation-Funktion ruft Informationen zu einer Richtlinienebene ab.

Syntax

BOOL SaferGetLevelInformation(
  [in]            SAFER_LEVEL_HANDLE      LevelHandle,
  [in]            SAFER_OBJECT_INFO_CLASS dwInfoType,
  [out, optional] LPVOID                  lpQueryBuffer,
  [in]            DWORD                   dwInBufferSize,
  [out]           LPDWORD                 lpdwOutBufferSize
);

Parameter

[in] LevelHandle

Das Handle der abzufragten Ebene.

[in] dwInfoType

Ein SAFER_OBJECT_INFO_CLASS Enumerationswert, der den Typ der Objektinformationen angibt, die zurückgegeben werden sollen. Der angegebene Wert bestimmt die Größe und den Typ des lpQueryBuffer-Parameters . In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert Bedeutung
SaferObjectLevelId
1
 Abfragen für die LEVELID-Konstante.

lpQueryBuffer-Rückgabetyp : DWORD.
SaferObjectScopeId
2
 Abfragen für den Benutzer- oder Computerbereich.

lpQueryBuffer-Rückgabetyp : DWORD.
SaferObjectFriendlyName
3
 Abfragen für den Anzeigenamen.

lpQueryBuffer-Rückgabetyp : LPCWSTR.
SaferObjectDescription
4
 Abfragen für die Beschreibung.

lpQueryBuffer-Rückgabetyp : LPCWSTR.

[out, optional] lpQueryBuffer

Ein Puffer, der die Ergebnisse der Abfrage enthält. Den Typ der zurückgegebenen Informationen für jeden möglichen Wert des dwInfoType-Parameters finden Sie im DwInfoType-Parameter .

[in] dwInBufferSize

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

[out] lpdwOutBufferSize

Ein Zeiger zum Zurückgeben der Ausgabegröße des lpQueryBuffer-Parameters .

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)