RasCreatePhonebookEntryA 函式 (ras.h)

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

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

語法

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

[in] unnamedParam1

對話方塊的父視窗控制碼。

[in] unnamedParam2

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

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

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

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

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

注意

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