NPGetConnection 函数 (npapi.h)

检索有关连接的信息。

语法

DWORD NPGetConnection(
  [in]      LPWSTR  lpLocalName,
  [out]     LPWSTR  lpRemoteName,
  [in, out] LPDWORD lpnBufferLen
);

[in] lpLocalName

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

[out] lpRemoteName

指向将接收用于建立连接的远程名称的缓冲区的指针。此缓冲区由调用方分配。

[in, out] lpnBufferLen

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

如果该函数成功，则它应返回WN_SUCCESS。否则，它应返回错误代码，可以是以下代码之一：

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

NPGetConnection 函数只能返回有关当前连接的网络连接的信息。若要检索有关当前已断开连接的网络连接的信息，请使用 NPGetConnection3。