다음을 통해 공유

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)을 반환하고 호출에 실패한 경우 0이 아닌 값을 반환합니다.

반환 코드/값 설명
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