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 中进行了协商。 应用程序将传递给 WinAPPC 启动 它可以使用的 Windows APPC 版本。 如果此版本低于 Windows APPC DLL 支持的最低版本，则 DLL 无法支持该应用程序， WinAPPCStartup 将失败。 但是，如果版本不低，则调用成功并返回 DLL 支持的 Windows APPC 的最高版本。 如果此版本低于应用程序支持的最低版本，则应用程序初始化失败或尝试在系统上查找另一个 Windows APPC DLL。

此协商允许 Windows APPC DLL 和 Windows APPC 应用程序支持一系列 Windows APPC 版本。 如果版本中存在任何重叠，应用程序可以成功使用 DLL。 下表说明了 WinAPPCStartup 如何与不同的应用程序和 DLL 版本结合使用。

应用程序版本	DLL 版本	To 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 实现必须在发出任何其他 Windows APPC 调用之前进行 WinAPPCStartup 调用。