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 支援版本。

WAPPCINVALID
此 DLL 不支援應用程式所指定的 Windows APPC 版本。

備註

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