RasCreatePhonebookEntryA 関数 (ras.h)
[この関数は Windows Vista の時点で非推奨となり、その機能は RasDialDlg に置き換えられました。 ]
RasCreatePhonebookEntry 関数は、新しい電話帳エントリを作成します。 この関数は、ユーザーが電話帳エントリの情報を入力するダイアログ ボックスを表示します。
構文
DWORD RasCreatePhonebookEntryA(
[in] HWND unnamedParam1,
[in] LPCSTR unnamedParam2
);
パラメーター
[in] unnamedParam1
ダイアログ ボックスの親ウィンドウへのハンドル。
[in] unnamedParam2
電話帳 (PBK) ファイルの完全なパスとファイル名を指定する null で終わる文字列へのポインター。 このパラメーターが NULL の場合、関数は現在の既定の電話帳ファイルを使用します。 既定の電話帳ファイルは、[ダイヤルアップ ネットワーク] ダイアログ ボックスの [ユーザー設定] プロパティ シートでユーザーが選択したファイルです。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS。
関数が失敗した場合、戻り値は次のいずれかのエラー コードか、 ルーティングとリモート アクセスのエラー コード または Winerror.h からの値です。
| リターン コード | 説明 |
|---|---|
|
電話帳が破損しているか、コンポーネントが見つかりません。 |
注釈
RasDialDlg を呼び出すときは、lpInfo に渡される RASDIALDLG 構造体の各メンバーを 0 に設定します。ただし、次の点を除く。
- dwSize = sizeof(RASDIALDLG)
- hwndOwner = 上記の hwnd パラメーター
- Dwflags = RASEDFLAG_NewEntry
注意
ras.h ヘッダーは、エイリアスとして RasCreatePhonebookEntry を定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと混在させると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ras.h |
| Library | Rasapi32.lib |
| [DLL] | Rasapi32.dll |