共用方式為

NPAddConnection 函式 （npapi.h）

NPAddConnection 函式會將本機裝置連線到網路資源。

語法

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

參數

[in] lpNetResource

NETRESOURCE 結構的指標，指定要連線的網路資源。 必須在您傳入的 NETRESOURCE 結構中設定下列欄位。 NPAddConnection 函式會忽略其他欄位。

價值觀 Meaning
lpRemoteName
 指定要連線的網路資源。
lp本地名稱
 指定要重新導向的本機裝置名稱，例如 “F：” 或 “LPT1”。 此名稱會被視為不區分大小寫，而且可能是空字串或 NULL 指標。 如果字串是空的或 Null，函式會連線到網路資源，而不進行重新導向。
dw類型
 指定要連線的資源類型。 這可以是 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
 網路不存在。

需求

Requirement 價值觀
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
Header npapi.h
Library davclnt.lib
  • Last updated on