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 (ゼロ) を返し、呼び出しが失敗した場合は 0 以外の値を返します。

リターン コード/値 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
Library Powrprof.lib
[DLL] Powrprof.dll