WinCSVStartup

WinCSVStartup 함수를 사용하면 애플리케이션에서 필요한 Windows CSV 버전을 지정하고 특정 Windows CSV 구현의 세부 정보를 검색할 수 있습니다. 이 함수는 추가 Windows CSV 호출을 실행하기 전에 Windows CSV 구현에 등록하려면 애플리케이션에서 호출해야 합니다.

구문

  
int WINAPI WinCSVStartup(   
WORD wVersionRequired,  
LPWCSVDATA lpwcsvdata  
);  

매개 변수

wVersionRequired
필요한 Windows CSV 지원 버전을 지정합니다. 상위 바이트는 부 버전(수정 버전) 번호를 지정합니다. 하위 바이트는 주 버전 번호를 지정합니다. Windows CSV API의 현재 버전은 1.0입니다.

lpwcsvdata
CSV 데이터 구조에 대한 포인터입니다. CSVDATA 구조체는 다음과 같이 정의됩니다.

typedef struct tagWCSVDATA {  
    WORD wVersion;  
    char szDescription[WCSVDESCRIPTION_LEN+1];  
}  CSVDATA, FAR * LPWCSVCDATA;  

여기서 WCSVDESCRIPTION은 127로 정의되고 구조체 멤버는 다음과 같습니다.

wVersion

지원되는 Windows CSV 버전입니다. 상위 바이트는 부 버전(수정 버전) 번호를 지정합니다. 하위 바이트는 주 버전 번호를 지정합니다.

szDescription

Windows CSV DLL의 공급업체를 식별하는 설명 문자열입니다.

이 CVSDATA 구조는 기본 Windows CSV DLL 구현에 대한 정보를 제공합니다. 첫 번째 wVersion 필드는 wVersionRequired 매개 변수와 구조가 동일하며 szDescription 필드에는 Windows CSV DLL의 공급업체를 식별하는 문자열이 포함되어 있습니다. 설명 필드는 애플리케이션에 대한 표시 문자열을 제공하기 위한 것일 뿐이며 Windows CSV 구현을 프로그래밍 방식으로 구분하는 데 사용하면 안 됩니다.

반환 값

반환 값은 애플리케이션이 성공적으로 등록되었는지 여부와 Windows CSV 구현이 지정된 버전 번호를 지원할 수 있는지 여부를 지정합니다. 값이 0이면 성공적으로 등록되었습니다. 그렇지 않으면 반환 값은 다음 중 하나입니다.

WCSVSYSNOTREADY
기본 네트워크 시스템이 네트워크 통신을 수행할 준비가 되지 않음을 나타냅니다.

WCSVVERNOTSUPPORTED
요청된 Windows CSV 지원 버전은 이 특정 Windows CSV 구현에서 제공되지 않습니다.

WCSVINVALID
애플리케이션에서 지정한 Windows CSV 버전은 이 DLL에서 지원되지 않습니다.

설명

Windows CSV 버전 1.0과 기능 차이가 있을 수 있는 향후 Windows CSV 구현 및 애플리케이션을 지원하기 위해 WinCSVStartup에서 협상이 진행됩니다. 애플리케이션은 사용할 수 있는 Windows CSV 버전을 WinCSVStartup 에 전달합니다. 이 버전이 Windows CSV DLL에서 지원하는 가장 낮은 버전보다 낮은 경우 DLL은 애플리케이션을 지원할 수 없으며 WinCSVStartup이 실패합니다. 그러나 버전이 낮지 않으면 호출이 성공하고 DLL에서 지원하는 가장 높은 버전의 Windows CSV를 반환합니다. 이 버전이 애플리케이션에서 지원하는 가장 낮은 버전보다 낮은 경우 애플리케이션은 초기화에 실패하거나 시스템에서 다른 Windows CSV DLL을 찾으려고 시도합니다.

이 협상을 통해 Windows CSV DLL과 Windows CSV 애플리케이션이 모두 다양한 Windows CSV 버전을 지원할 수 있습니다. 버전이 겹치는 경우 애플리케이션에서 DLL을 성공적으로 사용할 수 있습니다. 다음 표에서는 WinCSVStartup 이 다른 애플리케이션 및 DLL 버전과 함께 작동하는 방법을 보여 줍니다.

애플리케이션 버전	DLL 버전	WinCSVStartup으로	WinCSVStartup에서	결과
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	WCSVINVALID	실패
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 CSV 호출을 수행한 후 애플리케이션은 WinCSVCleanup을 호출해야 합니다.

각 Windows CSV 구현은 다른 Windows CSV 호출을 실행하기 전에 WinCSVStartup 호출을 수행해야 합니다. 따라서 이 함수를 초기화 목적으로 사용할 수 있습니다.