WinRUI
WinRUI 함수는 모든 Microsoft® Windows® 기반 RUI(요청 단위 인터페이스) 동사에 대해 비동기 메시지 알림을 제공합니다.
구문
int WINAPI WinRUI(
HWND hWnd,
LUA_VERB_RECORD FAR *lpVCB
);
매개 변수
hWnd
메시지를 받을 창의 핸들입니다.
lpVCB
LUA(논리 단위 애플리케이션) VCB(동사 제어 블록) LUA_VERB_RECORD 대한 포인터입니다.
반환 값
함수는 처리를 위해 Windows 기반 RUI에서 요청을 수락했는지 여부를 나타내는 값을 반환합니다. 반환된 값이 0이면 요청이 수락되고 처리됨을 나타냅니다. 0이 아닌 값은 오류를 나타냅니다. 가능한 오류 코드는 다음과 같습니다.
WLUAINVALIDHANDLE
제공된 창 핸들이 잘못되었습니다.
WLUASTARTUPNOTCALLED
애플리케이션이 WinRUIStartup을 사용하여 세션을 시작하지 않았습니다.
lua_flag2.async에서 반환되는 값은 비동기 알림이 발생하는지 여부를 나타냅니다. 플래그가 설정되면(0이 아닌 경우) 애플리케이션 메시지 큐에 게시된 메시지를 통해 비동기 알림이 발생합니다. 플래그가 설정되지 않은 경우 요청이 동기적으로 완료됩니다. 오류 조건에 대한 기본 반환 코드 및 보조 반환 코드를 검사합니다.
설명
비동기 작업이 완료되면 애플리케이션 창 hWnd 는 "WinRUI"를 입력 문자열로 사용하여 RegisterWindowMessage 에서 반환된 메시지를 받습니다. lParam 인수에는 완료로 게시되는 VCB의 주소가 포함됩니다. wParam 인수가 정의되지 않았습니다.
참고
처리를 위해 요청을 수락할 수 있지만(함수 호출은 0을 반환함) 나중에 VCB에 설정된 기본 반환 코드 및 보조 반환 코드로 거부됩니다. 오류 조건에 대한 기본 반환 코드 및 보조 반환 코드를 검사합니다.
애플리케이션이 WinRUIStartup을 사용하여 세션을 처음 초기화하지 않고 WinRUI를 호출하면 오류가 반환됩니다.