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 實作是否可以支援指定的版本號碼。 如果值為零，表示它已成功註冊。 否則，傳回值為下列其中一項：

WCSVSYSNOTREADY
表示基礎網路系統尚未準備好進行網路通訊。

WCSVVERNOTSUPPORTED
此特定 Windows CSV 實作不提供所要求的 Windows CSV 支援版本。

WCSVINVALID
此 DLL 不支援應用程式指定的 Windows CSV 版本。

備註

為了支援未來可能與 Windows CSV 1.0 版功能差異的 Windows CSV 實作和應用程式， WinCSVStartup中會進行交涉。 應用程式會傳遞至 WinCSVStartup 它可以使用的 Windows CSV 版本。 如果此版本低於 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 實作都必須進行 WinCSVStartup 呼叫，才能發出任何其他 Windows CSV 呼叫。 因此，此函式可用於初始化用途。