RasCreatePhonebookEntryA 函式（ras.h）

[從 Windows Vista 起，此函式已被取代，其功能已由 RasDialDlg取代。 ]

RasCreatePhonebookEntry 函式會建立新的電話簿專案。函式會顯示對話框，其中使用者輸入電話簿項目的資訊。

語法

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

[in] unnamedParam1

對話框的父視窗句柄。

[in] unnamedParam2

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

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

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

傳回碼	描述
ERROR_CANNOT_OPEN_PHONEBOOK	電話簿已損毀或遺失元件。

呼叫 RasDialDlg時，請將傳遞至 lpInfo 結構 RASDIALDLG 的每個成員設定為零：

注意

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

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