SaferCreateLevel 函式 (winsafer.h)

  • 發行項

SaferCreateLevel 函式會開啟SAFER_LEVEL_HANDLE。

語法

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

參數

[in] dwScopeId

要建立的層級範圍。 下表顯示可能的值。

值 意義
SAFER_SCOPEID_MACHINE
1
 所建立層級的範圍是計算機。
SAFER_SCOPEID_USER
2
 所建立層級的範圍是由使用者所指定。

[in] dwLevelId

要開啟之句柄的層級。 下表顯示可能的值。

值 意義
SAFER_LEVELID_CONSTRAINED
0x10000
 不論使用者的使用者權力為何，軟體都無法存取特定資源，例如密碼編譯密鑰和認證。
SAFER_LEVELID_DISALLOWED
0x00000
 不論使用者的使用者權力為何，軟體都不會執行。
SAFER_LEVELID_FULLYTRUSTED
0x40000
 軟體用戶權力取決於用戶的用戶權力。
SAFER_LEVELID_NORMALUSER
0x20000
 可讓程式以沒有 系統管理員 或 Power User使用者權力的使用者 身分執行。 軟體可以存取一般使用者可存取的資源。
SAFER_LEVELID_UNTRUSTED
0x01000
 可讓程式只對授與許可權的資源執行，以開啟已知的群組、封鎖 系統管理員 和 Power User 許可權的存取，以及個人授與許可權。

[in] OpenFlags

這可以是下列值。

值 意義
SAFER_LEVEL_OPEN
1

[out] pLevelHandle

傳回的SAFER_LEVEL_HANDLE。 當您完成使用句柄時，請呼叫 SaferCloseLevel 函式來關閉它。

lpReserved

這個參數保留給未來使用。 將它設定為 NULL。

傳回值

如果成功或零，則傳回非零。

如需擴充的錯誤資訊，請呼叫 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) 中引進