NPAddConnection 函数（npapi.h）

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

Syntax

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

[in] lpNetResource

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

价值	Meaning
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。否则，它应返回错误代码，可以是以下代码之一。

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

此页面是否有帮助？