WinAPPCStartup

WinAPPCStartup 函数允许应用程序指定所需的 Windows APPC 版本，并检索特定 Windows APPC 实现的详细信息。 应用程序必须调用此函数才能在发出任何进一步的 Windows APPC 调用之前向 Windows APPC 实现注册自身。

Syntax

  
            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 版本 1.0 功能差异的 Windows APPC 实现和应用程序， 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 版本结合使用。

WinAPPCStartup 返回的 WAPPCDATA 结构中描述了实际 Windows APPC 实现的详细信息：

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 实现都必须在发出任何其他 Windows APPC 调用之前进行 WinAPPCStartup 调用。