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 中的值。
傳回碼 | 描述 |
---|---|
|
電話簿已損毀或遺失元件。 |
備註
呼叫RasDialDlg時,請將傳遞至lpInfo之RASDIALDLG結構的每個成員設定為零,但:
- dwSize = sizeof (RASDIALDLG)
- hwndOwner = 上述 hwnd 參數
- dwFlags = RASEDFLAG_NewEntry
注意
ras.h 標頭會根據 UNICODE 預處理器常數的定義,將 RasCreatePhonebookEntry 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | ras.h |
程式庫 | Rasapi32.lib |
Dll | Rasapi32.dll |