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 的值。
值 | 意義 |
---|---|
|
RASAUTODIALENTRY 結構的 dwSize 成員是無效的值。 |
|
lpszAddress 參數為 NULL。 |
|
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 |