检索有关连接的信息。
Syntax
DWORD NPGetConnection(
[in] LPWSTR lpLocalName,
[out] LPWSTR lpRemoteName,
[in, out] LPDWORD lpnBufferLen
);
参数
[in] lpLocalName
指向调用方感兴趣的本地设备名称的指针。 网络提供程序可以假定此名称在语法上有效。
[out] lpRemoteName
指向将接收用于建立连接的远程名称的缓冲区的指针。 此缓冲区由调用方分配。
[in, out] lpnBufferLen
指向 lpRemoteName 缓冲区的大小(以字符为单位)的指针。 如果调用失败,因为缓冲区不够大, 则 lpBufferSize 设置为所需的缓冲区大小。
返回值
如果函数成功,它应返回WN_SUCCESS。 否则,它应返回错误代码,可以是下列代码之一:
| 返回代码 | Description |
|---|---|
|
此提供程序未重定向 lpLocalName 指定的设备。 |
|
缓冲区太小,无法接收所有数据。 |
|
网络不存在。 |
注解
NPGetConnection 函数只能返回有关当前连接的网络连接的信息。 若要检索有关当前断开连接的网络连接的信息,请使用 NPGetConnection3。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows XP [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| Header | npapi.h |
| Library | davclnt.lib |