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	网络不存在。