WinAPPCStartup 함수를 사용하면 애플리케이션이 필요한 Windows APPC 버전을 지정하고 특정 Windows APPC 구현의 세부 정보를 검색할 수 있습니다. 애플리케이션은 추가 Windows APPC 호출을 실행하기 전에 이 함수를 호출하여 Windows APPC 구현에 등록해야 합니다.
구문
int WINAPI WinAPPCStartup(
WORDwVersionRequired,
LPWAPPCDATAlpAPPCData
);
typedef struct {
WORD wVersion;
char szDescription[WAPPCDESCRIPTION_LEN+1];
} WAPPCDATA, FAR * LPWAPPCDATA;
where WAPPCDESCRIPTION_LEN is defined as 127
매개 변수
wVersionRequired
필요한 Windows APPC 지원 버전을 지정합니다. 상위 바이트는 부 버전(수정 버전) 번호를 지정합니다. 낮은 순서의 바이트는 주 버전 번호를 지정합니다. Windows APPC API의 현재 버전은 1.0입니다.
lpAPPCData
Windows APPC 버전 번호와 Windows APPC 구현에 대한 설명을 포함하는 반환된 구조체에 대한 포인터입니다.
반환 값
반환 값은 애플리케이션이 성공적으로 등록되었는지 여부와 Windows APPC 구현이 지정된 버전 번호를 지원할 수 있는지 여부를 지정합니다. 값이 0이면 성공적으로 등록되었으며 지정된 버전을 지원될 수 있습니다. 그렇지 않으면 반환 값은 다음 중 하나입니다.
WAPPCSYSNOTREADY
기본 네트워크 시스템이 네트워크 통신을 수행할 준비가 되지 않았습니다.
WAPPCVERNOTSUPPORTED
요청된 Windows APPC 지원 버전은 이 특정 Windows APPC 구현에서 제공되지 않습니다.
WAPPCINVALID
애플리케이션에서 지정한 Windows APPC 버전은 이 DLL에서 지원되지 않습니다.
설명
Windows APPC 버전 1.0과 기능 차이가 있을 수 있는 향후 Windows APPC 구현 및 애플리케이션을 지원하기 위해 WinAPPCStartup에서 협상이 진행됩니다. 애플리케이션이 사용할 수 있는 Windows APPC 버전을 WinAPPCStartup 에 전달합니다. 이 버전이 Windows APPC DLL에서 지원하는 가장 낮은 버전보다 낮은 경우 DLL은 애플리케이션을 지원할 수 없으며 WinAPPCStartup이 실패합니다. 그러나 버전이 낮지 않으면 호출이 성공하고 DLL에서 지원하는 가장 높은 버전의 Windows APPC를 반환합니다. 이 버전이 애플리케이션에서 지원하는 가장 낮은 버전보다 낮으면 애플리케이션이 초기화에 실패하거나 시스템에서 다른 Windows APPC DLL을 찾으려고 시도합니다.
이 협상을 통해 Windows APPC DLL과 Windows APPC 애플리케이션 모두 다양한 Windows APPC 버전을 지원할 수 있습니다. 버전에 중복이 있는 경우 애플리케이션에서 DLL을 성공적으로 사용할 수 있습니다. 다음 표에서는 WinAPPCStartup 이 다른 애플리케이션 및 DLL 버전과 함께 작동하는 방법을 보여 줍니다.
| 애플리케이션 버전 | DLL 버전 | WinAPPCStartup으로 | WinAPPCStartup에서 | 결과 |
|---|---|---|---|---|
| 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 | WAPPCINVALID | 실패 |
| 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 사용 |
실제 Windows APPC 구현에 대한 세부 정보는 WinAPPCStartup에서 반환되는 다음과 같이 정의된 WAPPCDATA 구조에 설명되어 있습니다.
typedef struct tagWAPPCDDATA { WORD wVersion;
char szDescription[WAPPCDESCRIPTION_LEN+1];
} WAPPCDATA, FAR *LPWAPPCDATA;
구조체 멤버는 다음과 같습니다.
wVersion
Windows APPC DLL에서 지원하는 가장 높은 APPC 버전 번호입니다.
szDescription
WinAPPC 구현을 설명하는 설명 문자열입니다.
마지막 Windows APPC 호출을 수행한 후 애플리케이션은 WinAPPCCleanup 루틴을 호출해야 합니다.
각 Windows APPC 구현은 다른 Windows APPC 호출을 실행하기 전에 WinAPPCStartup 호출을 수행해야 합니다.