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，結構成員如下：

w版本

支援的 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
應用程式指定的 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 版本有重疊，應用程式即可成功使用 DLL。 下表說明 WinCSVStartup 如何與不同應用程式及 DLL 版本協同運作。

在完成最後一次 Windows CSV 呼叫後，應用程式應該會呼叫 WinCSVCleanup。

每個 Windows CSV 實作必須先呼叫 WinCSVStartup ，才能發出其他 Windows CSV 呼叫。 因此，這個函式可用於初始化用途。