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