RasEditPhonebookEntryA 函式 (ras.h)

[自 Windows Vista 起，此函式已被取代，且其功能已由 RasEntryDlg 取代。]

RasEditPhonebookEntry 函式會編輯現有的電話簿專案。函式會顯示對話框，用戶可以在其中修改現有的資訊。

語法

DWORD RasEditPhonebookEntryA(
  [in] HWND   unnamedParam1,
  [in] LPCSTR unnamedParam2,
  [in] LPCSTR unnamedParam3
);

[in] unnamedParam1

對話框之父視窗的句柄。

[in] unnamedParam2

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

[in] unnamedParam3

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

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

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

傳回碼	Description
ERROR_BUFFER_INVALID	電話簿輸入緩衝區無效。
ERROR_CANNOT_OPEN_PHONEBOOK	電話簿已損毀或遺失元件。
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	電話簿專案不存在。

呼叫 RasEntryDlg 時，請將傳遞給 lpinfo 的 RASENTRYDLG 結構的每個成員設定為零，但：

注意

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

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