AccSetRunningUtilityState 함수(oleacc.h)

아티클
08/25/2023

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이거나 다음 값의 조합일 수 있습니다.

값	의미
ANRUS_ON_SCREEN_KEYBOARD_ACTIVE 0x0000001	AT 애플리케이션은 화상 키보드를 제공합니다.
ANRUS_TOUCH_MODIFICATION_ACTIVE 0x0000002	AT 애플리케이션은 리디렉션된 터치 입력을 사용합니다.
ANRUS_PRIORITY_AUDIO_ACTIVE 0x0000004	AT 애플리케이션은 사용자에게 필수 정보를 전달하기 위해 오디오(예: 텍스트 음성 변환)를 사용하고 있으며 다른 시스템 소리에 대해 계속 들을 수 있어야 합니다.
ANRUS_PRIORITY_AUDIO_ACTIVE_NODUCK 0x0000008	AT 애플리케이션은 사용자에게 필수 정보를 전달하기 위해 오디오(예: 텍스트 음성 변환)를 사용하지만 다른 시스템 소리에 따라 변경해서는 안 됩니다.

반환 값

형식: 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

추가 정보

보조 기술에 대한 보안 고려 사항

Share via