RasSetSubEntryPropertiesA 函式 (ras.h)

  • 發行項

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 終止字串的指標，指定電話簿 (PBK) 檔案的完整路徑和檔名。 如果此參數為 NULL，函式會使用目前的默認電話簿檔案。 默認電話簿檔案是由 [撥號網络] 對話方塊的 [ 用戶喜好設定 ] 屬性表中的使用者所選取的 檔案 。

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

[in] unnamedParam2

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

[in] unnamedParam3

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

[in] unnamedParam4

指定子實體數據的 RASSUBENTRY 結構的指標。

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

[in] unnamedParam5

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

[in] unnamedParam6

TAPI 裝置組態區塊的指標。 此參數目前未使用。 呼叫端應該傳遞此參數的 NULL 。 如需 TAPI 裝置設定區塊的詳細資訊，請參閱函式 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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 ras.h
程式庫 Rasapi32.lib
Dll Rasapi32.dll

另請參閱

RASENTRY

RASSUBENTRY

RasGetEntryProperties

遠端訪問服務 (RAS) 概觀

遠端存取服務函式