AccSetRunningUtilityState 함수(oleacc.h)
AT(보조 기술) 애플리케이션의 현재 상태가 일반적으로 시스템에서 제공하는 기능에 영향을 미치는지 여부를 나타내는 시스템 값을 설정합니다.
구문
HRESULT AccSetRunningUtilityState(
[in] HWND hwndApp,
[in] DWORD dwUtilityStateMask,
[in] DWORD dwUtilityState
);
매개 변수
[in] hwndApp
형식: HWND
AT 애플리케이션 창의 핸들입니다. 이 매개 변수는 NULL이 아니어야 합니다.
[in] dwUtilityStateMask
형식:DWORD
A
설정되는 시스템 값을 나타내는 mask입니다. 다음 값의 조합일 수 있습니다.
ANRUS_ON_SCREEN_KEYBOARD_ACTIVE
ANRUS_TOUCH_MODIFICATION_ACTIVE
ANRUS_PRIORITY_AUDIO_ACTIVE
ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK
[in] dwUtilityState
형식:DWORD
dwUtilityStateMask로 표시된 시스템 값에 대한 새 설정입니다. 이 매개 변수는 시스템 값을 다시 설정하는 데 0이거나 다음 값의 조합일 수 있습니다.
반환 값
형식: STDAPI
성공하면 S_OK를 반환합니다.
성공하지 못하면 표준 COM 오류 코드를 반환합니다.
설명
AT 애플리케이션이 종료되기 전에 이전에 설정한 시스템 값을 다시 설정해야 합니다.
이 함수를 사용하려면 호출 프로세스에 UIAccess 이상의 권한이 있어야 합니다. 호출자에게 필요한 권한이 없으면 AccSetRunningUtilityState 에 대한 호출이 실패하고 E_ACCESSDENIED 반환합니다. 자세한 내용은 보조 기술에 대한 보안 고려 사항 및 /MANIFESTUAC(매니페스트에 UAC 정보 포함)를 참조하세요.
예제
이 코드 예제에서는 AccSetRunningUtilityState 함수를 호출하는 방법을 보여 줍니다.
if (SUCCEEDED(hr))
{
// Tell the system that an AT application has registered with the
// touch redirector.
hr = AccSetRunningUtilityState(hwndTouchWindow,
ANRUS_TOUCH_MODIFICATION_ACTIVE,
ANRUS_TOUCH_MODIFICATION_ACTIVE);
if (FAILED(hr))
{
MyErrorHandler(hr); // Application-defined error handler
}
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | oleacc.h |
| 라이브러리 | Oleacc.lib |
| DLL | Oleacc.dll |