RasSetSubEntryPropertiesA 函式（ras.h）

發行項
11/20/2024

RasSetSubEntryProperties 函式會建立新的子專案，或修改指定之電話簿專案的現有子專案。

語法

DWORD RasSetSubEntryPropertiesA(
  [in] LPCSTR         unnamedParam1,
  [in] LPCSTR         unnamedParam2,
  [in] DWORD          unnamedParam3,
  [in] LPRASSUBENTRYA unnamedParam4,
  [in] DWORD          unnamedParam5,
  [in] LPBYTE         unnamedParam6,
  [in] DWORD          unnamedParam7
);

參數

[in] unnamedParam1

null終止字串的指標，指定電話簿檔案的完整路徑和檔名。如果此參數 NULL，則函式會使用目前的預設電話簿檔案。默認的電話簿檔案是使用者在 [撥號網络] 對話框中 [使用者 喜好設定] 屬性表中選取的默認電話簿檔案。

Windows Me/98/95：此參數一律 NULL。撥號網路會將電話簿專案儲存在登錄中，而不是儲存在電話簿檔案中。

[in] unnamedParam2

null終止字串的指標，指定電話簿中現有項目的名稱。

[in] unnamedParam3

指定子項目的單一型索引。如果索引符合現有的子專案索引，函式會變更該子實體的屬性。如果索引不符合現有的索引，函式會建立新的子專案。

[in] unnamedParam4

指定子項目數據的 RASSUBENTRY 結構的指標。

結構後面可能接著 null 陣列，終止的替代電話號碼字串。最後一個字串會以兩個連續的 null 字元終止。 dwAlternateOffsetRASSUBENTRY 結構的成員包含第一個字元串的位移。

[in] unnamedParam5

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

[in] unnamedParam6

TAPI 裝置組態區塊的指標。此參數目前未使用。呼叫端應該傳遞此參數 NULL。如需 TAPI 裝置組態區塊的詳細資訊，請參閱 function lineGetDevConfig。

[in] unnamedParam7

指定 TAPI 裝置組態區塊的大小。此參數目前未使用。呼叫端應該為此參數傳遞零。

傳回值

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

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

價值	意義
ERROR_BUFFER_INVALID	lpRasEntry 所指定的位址或緩衝區無效。
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	電話簿專案不存在。
ERROR_CANNOT_OPEN_PHONEBOOK	電話簿已損毀或遺失元件。
ERROR_INVALID_PARAMETER	函式是以無效的參數呼叫。

言論

RAS 電話簿專案可以有零或多個子專案，每個子專案都是由裝置和電話號碼所組成。具有多個子項目的電話簿專案可以設定為在撥打專案時撥打第一個可用的子專案或所有子專案。

使用 RasGetEntryProperties 函式來擷取包含電話簿專案子專案相關信息的 RASENTRY 結構。 dwSubEntries 成員表示子項目的數目，而 dwDialMode 成員表示撥號組態。

注意

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

要求

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