WinAPPCStartup

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 實作是否能支援指定的版本號。 若值為零，表示已成功註冊，且可支援指定版本。 否則，返回值為以下之一：

WAPPCSYSNOTREADY
底層網路系統尚未準備好進行網路通訊。

WAPPCVERNOTSUPPORTED
所要求的 Windows APPC 支援版本並非由此特定 Windows APPC 實作提供。

瓦普辛瓦爾德
該應用程式指定的 Windows APPC 版本不被此 DLL 支援。

備註

為了支援未來 Windows APPC 實作及可能與 Windows APPC 1.0 版本功能有差異的應用程式，會在 WinAPPCStartup 中進行協商。 應用程式會將 Windows APPC 版本傳給 WinAPPCStartup 。 若此版本低於 Windows APPC DLL 支援的最低版本，DLL 將無法支援該應用程式， WinAPPCStartup 將失敗。 但若版本不低於，呼叫成功，並回傳 DLL 支援的最高 Windows APPC 版本。 若此版本低於應用程式支援的最低版本，應用程式要麼初始化失敗，要麼嘗試在系統上尋找其他 Windows APPC DLL。

此協商允許 Windows APPC DLL 與 Windows APPC 應用程式支援多種 Windows APPC 版本。 若 DLL 版本有重疊，應用程式即可成功使用 DLL。 下表說明 WinAPPCStartup 如何與不同應用程式及 DLL 版本協同運作。

實際 Windows APPC 實作的細節可參考 WinAPPCStartup 回傳的 WAPPCDATA 結構，定義如下：

typedef struct tagWAPPCDDATA { WORD wVersion;  
char szDescription[WAPPCDESCRIPTION_LEN+1];  
} WAPPCDATA, FAR *LPWAPPCDATA;  

結構成員如下所示：

w版本
Windows APPC DLL 支援的最高 APPC 版本號。

szDescription
描述 WinAPPC 實作的描述字串。

在最後一次 Windows APPC 呼叫後，應用程式應該呼叫 WinAPPCCleanup 例程。

每個 Windows APPC 實作必須先呼叫 WinAPPCStartup ，才能發出其他 Windows APPC 呼叫。