NPGetConnection3 函数 (npapi.h)

  • 项目

检索有关网络连接的信息，即使它当前已断开连接。

语法

DWORD NPGetConnection3(
  [in]      LPCWSTR lpLocalName,
  [in]      DWORD   dwLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

参数

[in] lpLocalName

指向调用方感兴趣的本地设备名称的指针。 提供程序可以假定这在语法上有效。

[in] dwLevel

指定网络连接当前是已连接还是已断开连接的值。

值 含义
WNGETCON_CONNECTED
 网络连接已连接。
WNGETCON_DISCONNECTED
 网络连接已断开连接。

[out] lpBuffer

接收包含所请求信息的缓冲区的 Void 指针。

[in, out] lpBufferSize

指向 lpBuffer 缓冲区的大小（以字符为单位）的指针。 如果调用因缓冲区不够大而失败， 则 lpBufferSize 设置为所需的缓冲区大小。

返回值

如果该函数成功，它应返回WN_SUCCESS。

如果函数失败，它应返回以下值之一。

返回代码 说明
WN_NOT_CONNECTED
 此提供程序不重定向 由 lpLocalName 指定的设备。
WN_MORE_DATA
 缓冲区太小，无法接收所有数据。
WN_NO_NETWORK
 网络不存在。

注解

网络连接可以存在三种状态：已连接、已断开连接和不可用。 NPGetConnection3 函数无法检索有关当前不可用的网络连接的信息。 但是，它可以检索有关当前断开连接的网络连接的信息，因为 Windows 存储连接信息。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 npapi.h