RasGetAutodialAddressA 函式 (ras.h)

發行項
03/05/2024

RasGetAutodialAddress 函式會擷取與自動對應資料庫中網路位址相關聯之所有自動串行專案的相關信息。

語法

DWORD RasGetAutodialAddressA(
  [in]      LPCSTR              unnamedParam1,
  [in]      LPDWORD             unnamedParam2,
  [in, out] LPRASAUTODIALENTRYA unnamedParam3,
  [in, out] LPDWORD             unnamedParam4,
  [out]     LPDWORD             unnamedParam5
);

參數

[in] unnamedParam1

Null 終止字串的指標，指定要求資訊的位址。這可以是IP位址、因特網主機名 (“www.microsoft.com”) 或 NetBIOS 名稱 (“products1”) 。

如果此參數為 NULL，函式會擷取預設因特網連線。如果已設定，此函式會傳回每個用戶的預設因特網連線。否則，函式會傳回全域預設因特網連線。如果未設定預設因特網連線，函式會傳回 lpdwcbAutoDialEntries 和 lpdwcAutoDialEntries 參數的零。

[in] unnamedParam2

保留;必須是 NULL。

[in, out] unnamedParam3

輸出中，緩衝區的指標會接收 RASAUTODIALENTRY 結構的陣列，其中一個用於 與 lpszAddress 參數所指定地址相關聯的每個 AutoDial 專案。

在輸入上，將緩衝區中第一個RASAUTODIALENTRY結構的 dwSize成員設定為sizeof (RASAUTODIALENTRY) ，以識別結構的版本。

如果 lpAutoDialEntries 為 NULL，RasGetAutodialAddress 會設定 lpdwcbAutoDialEntries 和 lpdwcAutoDialEntries 參數，以位元組為單位，以及自動傳送專案的數目。

[in, out] unnamedParam4

在輸入上指定 lpAutoDialEntries 緩衝區的大小，以位元組為單位的變數指標。

輸出時，這個變數會接收傳回的位元元組數，或緩衝區太小時所需的位元組數目。

[out] unnamedParam5

變數的指標，這個變數會接收 lpAutoDialEntries 緩衝區中傳回的結構項目數目。

傳回值

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

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

值	意義
ERROR_INVALID_SIZE	RASAUTODIALENTRY 結構的 dwSize 成員是無效的值。
ERROR_INVALID_PARAMETER	lpszAddress、lpdwcbAutoDialEntries 或 lpdwcAutoDialEntries 參數為 NULL。

備註

遠端訪問服務 (RAS) 支援預設因特網連線。 RAS 支援本機計算機全域的預設因特網連線，此外，也支援每個用戶的預設因特網連線。

全域預設因特網連線的名稱會儲存在下列登錄機碼下方的登錄中：

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Ras Autodial
            Default

儲存連線名稱的值為：

DefaultInternet

這個值的類型為 REG_SZ。

全域預設因特網連線必須設定為 Connections Folder 使用者介面中的 [所有用戶連線]。

每個使用者預設因特網連線的名稱會儲存在下列登入機碼下方的登入中：

\ HKEY_CURRENT_USER軟體\微軟\Ras 自動串行\預設

儲存連線名稱的值為：

DefaultInternet

這個值的類型為 REG_SZ。

注意

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

規格需求

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