WinRUIStartup
WinRUIStartup 함수를 사용하면 RUI(요청 단위 인터페이스) 동사를 사용하는 애플리케이션이 필요한 LUA(Windows 논리 단위 애플리케이션) 버전을 지정하고 특정 Microsoft Windows LUA 구현의 세부 정보를 검색할 수 있습니다. 이 함수는 추가 Windows LUA 호출을 실행하기 전에 Windows LUA 구현에 등록하려면 애플리케이션에서 호출해야 합니다.
구문
int WINAPI WinRUIStartup(
WORD wVersionRequired,
LUADATA FAR *lpLuaData );
매개 변수
wVersionRequired
필요한 Windows LUA 지원 버전을 지정합니다. 상위 바이트는 부 버전(수정 버전) 번호를 지정합니다. 하위 바이트는 주 버전 번호를 지정합니다.
lpLuaData
반환된 버전 번호 정보를 포함하는 LUADATA 구조체에 대한 포인터입니다.
반환 값
반환 코드는 애플리케이션이 성공적으로 등록되었는지 여부와 Windows LUA 구현이 지정된 버전 번호를 지원할 수 있는지 여부를 지정합니다. 값이 0이면 성공적으로 등록되었으며 지정된 버전을 지원될 수 있습니다. 그렇지 않으면 반환 코드는 다음 중 하나입니다.
WLUASYSNOTREADY
기본 네트워크 시스템은 네트워크 통신을 수행할 준비가 되지 않았습니다.
WLUAVERNOTSUPPORTED
요청된 Windows LUA 지원 버전은 이 특정 Windows LUA 구현에서 제공되지 않습니다.
WLUAINVALID
애플리케이션에서 지정한 Windows LUA 버전은 이 DLL(동적 연결 라이브러리)에서 지원되지 않습니다.
WLUAFAILURE
Windows LUA DLL을 초기화하는 동안 오류가 발생했습니다. 이는 일반적으로 운영 체제 호출이 실패했기 때문에 발생합니다.
WLUAINITREJECT
WinRUIStartup 이 여러 번 호출되었습니다.
설명
기능 차이가 있을 수 있는 향후 Windows LUA 구현 및 애플리케이션을 지원하기 위해 WinRUIStartup에서 협상이 진행됩니다. 애플리케이션이 WinRUI 에 전달하여 사용할 수 있는 Windows LUA 버전을 시작합니다. 이 버전이 Windows LUA DLL에서 지원하는 가장 낮은 버전보다 낮은 경우 DLL은 애플리케이션을 지원할 수 없으며 WinRUIStartup이 실패합니다. 그러나 버전이 낮지 않으면 호출이 성공하고 DLL에서 지원하는 가장 높은 버전의 Windows LUA를 반환합니다. 이 버전이 애플리케이션에서 지원하는 가장 낮은 버전보다 낮으면 애플리케이션이 초기화에 실패하거나 시스템에서 다른 Windows LUA DLL을 찾으려고 시도합니다.
이 협상을 통해 Windows LUA DLL과 Windows LUA 애플리케이션이 모두 다양한 Windows LUA 버전을 지원할 수 있습니다. 버전이 겹치는 경우 애플리케이션에서 DLL을 성공적으로 사용할 수 있습니다. 다음 표에서는 WinRUIStartup 이 다른 애플리케이션 및 DLL 버전과 함께 작동하는 방법을 보여 줍니다.
| LUA 앱 버전 | LUA DLL 버전 | 대상 WinRUIStartup |
시작 WinRUIStartup |
결과 |
|---|---|---|---|---|
| 1.0 | 1.0 | 1.0 | 1.0 | 1.0 사용 |
| 1.0, 2.0 | 1.0 | 2.0 | 1.0 | 1.0 사용 |
| 1.0 | 1.0, 2.0 | 1.0 | 2.0 | 1.0 사용 |
| 1.0 | 2.0, 3.0 | 1.0 | WLUAINVALID | 실패 |
| 2.0, 3.0 | 1.0 | 3.0 | 1.0 | 앱 실패 |
| 1.0, 2.0, 3.0 | 1.0, 2.0, 3.0 | 3.0 | 3.0 | 3.0 사용 |
참고
RUI 동사를 사용하는 애플리케이션은 다른 LUA 명령을 실행하기 전에 WinRUIStartup 을 호출해야 합니다. 그러나 WinRUIStartup 은 애플리케이션당 한 번만 호출해야 합니다. 이 호출이 여러 번 호출되면 후속 호출이 거부됩니다.
실제 LUA 구현에 대한 세부 정보는 다음과 같이 정의된 WLUADATA 구조에 설명되어 있습니다.
typedef struct { WORD wVersion;
char szDescription[WLUADESCRIPTION_LEN+1];
} LUADATA;
마지막 Windows LUA 호출을 수행한 후 애플리케이션은 WinRUICleanup 루틴을 호출해야 합니다.
RUI 동사를 사용하는 각 LUA 애플리케이션은 다른 LUA 호출을 실행하기 전에 WinRUIStartup 호출을 수행해야 합니다.