通过

NPGetConnection3 函数 （npapi.h）

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

Syntax

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

参数

[in] lpLocalName

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

[in] dwLevel

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

价值 Meaning
WNGETCON_CONNECTED
 网络连接已连接。
WNGETCON_DISCONNECTED
 网络连接已断开连接。

[out] lpBuffer

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

[in, out] lpBufferSize

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

返回值

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

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

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

注解

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

要求

Requirement 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows操作系统
Header npapi.h
Library nanosrv.lib