RasSetAutodialAddressA 函式 (ras.h)

  • 發行項

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

語法

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 name (“products1”) 。

If this parameter is NULL, the function sets the default Internet connection (see Remarks). 如果此參數指向長度為零的字串，函式會刪除預設因特網連線。

[in] unnamedParam2

保留;必須是零。

[in] unnamedParam3

要與 lpszAddress 位址相關聯之一或多個 RASAUTODIALENTRY 結構的陣列指標。 如果 lpAutoDialEntries 為 NULL 且 dwcbAutoDialEntries 為零， RasSetAutodialAddress 會從對應資料庫刪除與 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 位址存在於資料庫中， lpAutoDialEntries 為 NULL，而 lpAutoDialEntries 為零， RasSetAutodialAddress 會從資料庫刪除位址。

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

RAS 支援預設因特網連線，此連線是本機計算機的全局連線，且支援每個使用者的預設因特網連線。

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

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

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

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

注意

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

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 ras.h
程式庫 Rasapi32.lib
Dll Rasapi32.dll

另請參閱

RASAUTODIALENTRY

RasEnumAutodialAddresses

RasGetAutodialAddress

遠端訪問服務 (RAS) 概觀

遠端存取服務函式