NPAddConnection 函数 (npapi.h)
NPAddConnection 函数将本地设备连接到网络资源。
语法
DWORD NPAddConnection(
[in] LPNETRESOURCEW lpNetResource,
[in] LPWSTR lpPassword,
[in] LPWSTR lpUserName
);
参数
[in] lpNetResource
指向 NETRESOURCE 结构的指针,该结构指定要连接到的网络资源。 必须在传入的 NETRESOURCE 结构中设置以下字段。 NPAddConnection 函数忽略其他字段。
[in] lpPassword
指向要用于建立连接的密码的指针,通常是与 lpUserName 关联的密码。 可以传入 NULL 值,使函数使用默认密码。 空字符串可用于指示没有密码。 使用完密码后,通过调用 SecureZeroMemory 函数从内存中清除密码。 有关保护密码的详细信息,请参阅 处理密码。
[in] lpUserName
指向用于建立连接的用户名的指针。 如果 为 NULL,则应用当前登录用户的默认用户名 () 。 当用户想要连接到某个资源,但为该资源分配了不同的用户名或帐户时,会使用此方法。
例如,如果使用用户名“MyAccount”登录,并且想要连接到仅可用于第二个帐户的网络资源,其中用户名为“MyOtherAccount”,则可以在 lpUserName 中指定“MyOtherAccount”以连接到资源。 还可以在 lpPassword 中指定第二个帐户的密码。
返回值
如果该函数成功,则它应返回WN_SUCCESS。 否则,它应返回错误代码,可能是以下代码之一。
返回代码 | 说明 |
---|---|
|
传递到 lpNetResource 的结构的 lpRemoteName 成员的值对此提供程序无效。 |
|
传递到 lpNetResource 的结构的 lpLocalName 成员的值无效。 |
|
指定的密码无效。 |
|
在传递到 lpNetResource 结构的 lpLocalName 成员中指定的设备已连接。 |
|
建立连接的权限被拒绝。 |
|
网络不存在。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | npapi.h |