RasEditPhonebookEntryA 関数 (ras.h)

[アーティクル]
03/01/2024

[この関数は Windows Vista の時点で非推奨となり、その機能は RasEntryDlg に置き換えられました。

RasEditPhonebookEntry 関数は、既存の電話帳エントリを編集します。関数は、ユーザーが既存の情報を変更できるダイアログボックスを表示します。

構文

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

パラメーター

[in] unnamedParam1

ダイアログボックスの親ウィンドウを処理します。

[in] unnamedParam2

電話帳 (PBK) ファイルの完全なパスとファイル名を指定する null で終わる文字列へのポインター。このパラメーターが NULL の場合、関数は現在の既定の電話帳ファイルを使用します。既定の電話帳ファイルは、[ダイヤルアップネットワーク] ダイアログボックスの [ユーザー設定] プロパティシートでユーザーが選択したファイルです。

[in] unnamedParam3

電話帳ファイル内の既存のエントリの名前を指定する null で終わる文字列へのポインター。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS。

関数が失敗した場合、戻り値は次のいずれかのエラーコードか、ルーティングおよびリモートアクセスエラーコードまたは Winerror.h からの値です。

リターンコード	説明
ERROR_BUFFER_INVALID	電話帳のエントリバッファーが無効です。
ERROR_CANNOT_OPEN_PHONEBOOK	電話帳が破損しているか、コンポーネントが見つかりません。
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	電話帳エントリが存在しません。

注釈

RasEntryDlg を呼び出すときに、lpinfo に渡される RASENTRYDLG 構造体の各メンバーを 0 に設定します。ただし、次の点を除きます。

dwSize = sizeof(RASENTRYDLG)
hwndOwner = 上記の hwnd パラメーター

注意

ras.h ヘッダーは RasEditPhonebookEntry をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	ras.h
Library	Rasapi32.lib
[DLL]	Rasapi32.dll