共用方式為


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。 否則,它應該會傳回錯誤碼,這可以是下列其中一項。

傳回碼 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
網路不存在。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 npapi.h