NPAddConnection 函数 (npapi.h)

NPAddConnection 函数将本地设备连接到网络资源。

语法

DWORD NPAddConnection(
  [in] LPNETRESOURCEW lpNetResource,
  [in] LPWSTR         lpPassword,
  [in] LPWSTR         lpUserName
);

参数

[in] lpNetResource

指向 NETRESOURCE 结构的指针,该结构指定要连接到的网络资源。 必须在传入的 NETRESOURCE 结构中设置以下字段。 NPAddConnection 函数忽略其他字段。

含义
lpRemoteName
指定要连接到的网络资源。
lpLocalName
指定要重定向的本地设备的名称,例如“F:”或“LPT1”。 此名称被视为不区分大小写,可以是空字符串或 NULL 指针。 如果字符串为空或 NULL,则函数连接到网络资源而不进行重定向。
dwType
指定要连接到的资源的类型。 这可以是RESOURCETYPE_DISK、RESOURCETYPE _PRINT或RESOURCETYPE_ANY。 如果调用方不关心或不知道,则使用 RESOURCETYPE _ANY值。

[in] lpPassword

指向要用于建立连接的密码的指针,通常是与 lpUserName 关联的密码。 可以传入 NULL 值,使函数使用默认密码。 空字符串可用于指示没有密码。 使用完密码后,通过调用 SecureZeroMemory 函数从内存中清除密码。 有关保护密码的详细信息,请参阅 处理密码

[in] lpUserName

指向用于建立连接的用户名的指针。 如果 为 NULL,则应用当前登录用户的默认用户名 () 。 当用户想要连接到某个资源,但为该资源分配了不同的用户名或帐户时,会使用此方法。

例如,如果使用用户名“MyAccount”登录,并且想要连接到仅可用于第二个帐户的网络资源,其中用户名为“MyOtherAccount”,则可以在 lpUserName 中指定“MyOtherAccount”以连接到资源。 还可以在 lpPassword 中指定第二个帐户的密码。

返回值

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

返回代码 说明
WN_BAD_NETNAME
传递到 lpNetResource 的结构的 lpRemoteName 成员的值对此提供程序无效。
WN_BAD_LOCALNAME
传递到 lpNetResource 的结构的 lpLocalName 成员的值无效。
WN_BAD_PASSWORD
指定的密码无效。
WN_ALREADY_CONNECTED
在传递到 lpNetResource 结构的 lpLocalName 成员中指定的设备已连接。
WN_ACCESS_DENIED
建立连接的权限被拒绝。
WN_NO_NETWORK
网络不存在。

要求

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