RasSetAutodialAddressA 函式（ras.h）

發行項
11/20/2024

RasSetAutodialAddress 函式可以將位址新增至自動對應資料庫。或者，函式可以刪除或修改資料庫中現有位址相關聯的數據。

語法

DWORD RasSetAutodialAddressA(
  [in] LPCSTR              unnamedParam1,
  [in] DWORD               unnamedParam2,
  [in] LPRASAUTODIALENTRYA unnamedParam3,
  [in] DWORD               unnamedParam4,
  [in] DWORD               unnamedParam5
);

參數

[in] unnamedParam1

null終止字串的指標，指定要新增、刪除或修改的位址。此位址可以是IP位址、因特網主機名（“www.microsoft.com”），或 NetBIOS 名稱（“products1” ）。

如果此參數 NULL，則函式會設定預設因特網連線（請參閱）。如果此參數指向長度為零的字串，函式會刪除預設因特網連線。

[in] unnamedParam2

保留;必須是零。

[in] unnamedParam3

與 lpszAddress 位址相關聯之一或多個 RASAUTODIALENTRY 之陣列的指標。如果 lpAutoDialEntries NULL 且 dwcbAutoDialEntries 為零，RasSetAutodialAddres s 會從對應資料庫刪除與 lpszAddress 相關聯的所有結構。

[in] unnamedParam4

指定 lpAutoDialEntries 緩衝區的大小，以位元組為單位。

[in] unnamedParam5

指定 lpAutoDialEntries 緩衝區中 RASAUTODIALENTRY 結構的數目。

傳回值

如果函式成功，則傳回值會 ERROR_SUCCESS。

如果函式失敗，傳回值是下列其中一個錯誤碼，或來自路由和遠端訪問錯誤碼的值或 Winerror.h。

價值	意義
ERROR_INVALID_SIZE	RASAUTODIALENTRY 結構的 dwSize 成員是無效的值。
ERROR_INVALID_PARAMETER	lpszAddress 參數 NULL。
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	lpAutoDialEntries 中指定的連接名稱不存在。

言論

自動串行化對應資料庫中的位址可以有任意數目的相關聯 RASAUTODIALENTRY 專案。每個項目都會指定特定 TAPI 撥號位置的自動串行資訊。

如果 lpszAddress 參數所指定的地址是資料庫中現有的位址，而且 lpAutoDialEntries 參數不是 NULL，則 RasSetAutodialAddress 函式會修改與地址相關聯的自動傳送專案集。如果 lpAutoDialEntries 中的專案 陣列指定地址已經有專案的撥號位置，則函式會將現有的專案取代為新的專案。否則，函式只會將 lpAutoDialEntries 專案新增至位址的專案集。

如果資料庫中有 lpszAddress 位址，lpAutoDialEntriesNULL，lpAutoDialEntries 為零，RasSetAutodialAddress 從資料庫刪除位址。

如果資料庫中沒有 lpszAddress 位址，RasSetAutodialAddress 將位址新增至資料庫。 lpAutoDialEntries 參數會指定要與新位址產生關聯的自動串行專案。

RAS 支援本機計算機全域的預設因特網連線，並支援每個用戶的預設因特網連線。

當 lpszAddress 參數 NULL時，lpAutoDialEntries 參數會指定一個專案的連接名稱，RasSetAutodialAddress 將連線設定為預設因特網連線。 lpAutoDialEntries 中指定的連接名稱 應該已經存在。如果沒有，則會傳回 ERROR_CANNOT_FIND_PHONEBOOK_ENTRY。

當 lpszAddress 參數是長度為零的字串，且 lpAutoDialEntries 參數會指定具有一個專案的空白連線名稱時，RasSetAutodialAddress 刪除預設因特網連線。

在非網域用戶端計算機上，如果使用者想要將連線設定為預設因特網連線，並在 szEnt ry 中指定「所有使用者」連線，RASAUTODIALENTRY 結構的成員，則會在本機計算機上全域設定預設因特網連線。在其他所有情況下，預設因特網聯機會個別設定給計算機的每個使用者。

如果一個連線設定為「所有使用者」連線，而且另一個連線設定為「僅限 me-only」連線，則可能會有兩個相同名稱的連線。如果 lpAutoDialEntries 參數指定對應至全域和每個用戶連線的連接名稱，則會設定每個用戶連線。

注意

ras.h 標頭會根據 UNICODE 預處理器常數的定義，將 RasSetAutodialAddress 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	ras.h
連結庫	Rasapi32.lib
DLL	Rasapi32.dll