PowerSettingAccessCheckEx 函式 (powrprof.h)

  • 發行項

針對指定的電源設定查詢組策略覆寫，並指定設定的要求存取權。

語法

DWORD PowerSettingAccessCheckEx(
  [in]           POWER_DATA_ACCESSOR AccessFlags,
  [in, optional] const GUID          *PowerGuid,
  [in]           REGSAM              AccessType
);

參數

[in] AccessFlags

要檢查組策略覆寫的存取類型。

值 意義
ACCESS_AC_POWER_SETTING_INDEX
0 (0x0)
檢查 AC 電源設定上的覆寫。
ACCESS_DC_POWER_SETTING_INDEX
1 (0x1)
檢查 DC 電源設定上的覆寫。
ACCESS_SCHEME
16 (0x10)
檢查特定電源配置的限制。
ACCESS_ACTIVE_SCHEME
19 (0x13)
檢查作用中電源配置的限制。
ACCESS_CREATE_SCHEME
20 (0x14)
檢查建立或還原電源配置的限制。

[in, optional] PowerGuid

電源設定的標識碼。

[in] AccessType

設定的安全性存取類型。 如需詳細資訊，請參閱 登錄機碼安全性和訪問許可權。

此參數可以是下列其中一個值。

值 意義
KEY_READ
 結合STANDARD_RIGHTS_READ、KEY_QUERY_VALUE、KEY_ENUMERATE_SUB_KEYS和KEY_NOTIFY值。
KEY_WRITE
 結合STANDARD_RIGHTS_WRITE、KEY_SET_VALUE和KEY_CREATE_SUB_KEY訪問許可權。

傳回值

如果呼叫成功，則傳回 ERROR_SUCCESS (零) ，如果呼叫失敗，則傳回非零值。

傳回碼/值 Description
ERROR_SUCCESS
0 (0x0)
組策略目前未覆寫指定的電源設定。
ERROR_ACCESS_DISABLED_BY_POLICY
1260 (0x4EC)
組策略會封鎖此程式。 如需詳細資訊，請連絡您的系統管理員。
ERROR_INSTALL_REMOTE_DISALLOWED
1640 (0x668)
只有系統管理員才能遠端存取電源設定。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 powrprof.h
程式庫 Powrprof.lib
Dll Powrprof.dll