SaferGetLevelInformation 函式 (winsafer.h)

  • 發行項

SaferGetLevelInformation 函式會擷取原則層級的相關信息。

語法

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

參數

[in] LevelHandle

要查詢之層級的句柄。

[in] dwInfoType

SAFER_OBJECT_INFO_CLASS列舉值，指定應該傳回的對象資訊類型。 指定的值會決定 lpQueryBuffer 參數的大小和類型。 下表顯示可能的值。

值 意義
SaferObjectLevelId
1
 LEVELID 常數的查詢。

lpQueryBuffer 傳 回類型： DWORD。
SaferObjectScopeId
2
 查詢使用者或計算機範圍。

lpQueryBuffer 傳 回類型： DWORD。
SaferObjectFriendlyName
3
 查詢顯示名稱。

lpQueryBuffer 傳回類型： LPCWSTR。
SaferObjectDescription
4
 描述的查詢。

lpQueryBuffer 傳回類型： LPCWSTR。

[out, optional] lpQueryBuffer

包含查詢結果的緩衝區。 如需 dwInfoType 參數每個可能值的傳回資訊類型，請參閱 dwInfoType 參數。

[in] dwInBufferSize

以位元組為單位的 lpQueryBuffer 參數大小。

[out] lpdwOutBufferSize

要傳回 lpQueryBuffer 參數輸出大小的指標。

傳回值

如果函式成功，則為TRUE;否則為 FALSE。 如需擴充錯誤資訊，請呼叫 GetLastError。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 winsafer.h
程式庫 Advapi32.lib
Dll Advapi32.dll
API 集合 ext-ms-win-advapi32-safer-l1-1-0 (中引進 Windows 8)