RasCustomEntryDlgFn
コールバックシグネチャ
BOOL RasCustomEntryDlgFn(
HINSTANCE hInstDll,
LPWSTR lpszPhonebook,
LPWSTR lpszEntry,
RASENTRYDLGA* lpInfo,
DWORD dwFlags
);パラメーター
| フィールド | 型 | 説明 |
|---|---|---|
| hInstDll | HINSTANCE | 読み込まれたカスタムダイヤル DLL のインスタンスへのハンドルです。 |
| lpszPhonebook | LPWSTR | 電話帳 (PBK) ファイルの完全なパスとファイル名を指定する null 終端文字列へのポインターです。このパラメーターが NULL の場合、関数は現在の既定の電話帳ファイルを使用します。既定の電話帳ファイルは、ダイヤルアップ ネットワーク ダイアログボックスの ユーザー設定 プロパティシートでユーザーが選択したものです。 |
| lpszEntry | LPWSTR | 編集、コピー、または作成する電話帳エントリの名前が格納された null 終端文字列へのポインターです。 エントリを編集またはコピーする場合、このパラメーターは既存の電話帳エントリの名前です。エントリをコピーする場合は、 RASENTRYDLG 構造体の dwFlags メンバーに RASEDFLAG_CloneEntry フラグを設定します。 エントリを作成する場合、このパラメーターはユーザーが変更できる既定の新しいエントリ名です。このパラメーターが NULL の場合、関数が既定の名前を提供します。エントリを作成する場合は、 RASENTRYDLG 構造体の dwFlags メンバーに RASEDFLAG_NewEntry フラグを設定します。 |
| lpInfo | RASENTRYDLGA* | 追加の入力パラメーターおよび出力パラメーターが格納された RASENTRYDLG 構造体へのポインターです。入力時には、この構造体の dwSize メンバーに sizeof( RASENTRYDLG) を指定する必要があります。エントリを作成するか、編集するか、コピーするかを示すには dwSize メンバーを使用します。エラーが発生した場合は dwError メンバーにエラーコードが返され、それ以外の場合は 0 が返されます。 |
| dwFlags | DWORD | 将来の使用のために予約されています。 |
公式ドキュメント
RasCustomEntryDlg 関数は、サードパーティ製のカスタムダイヤル DLL からエクスポートされる、アプリケーション定義の関数です。この関数により、サードパーティのベンダーは電話帳エントリを管理するためのカスタムダイアログを実装できます。
戻り値
ユーザーが電話帳エントリを作成、コピー、または編集した場合、戻り値は TRUE にする必要があります。それ以外の場合、この関数は FALSE を返す必要があります。
エラーが発生した場合、RasCustomEntryDlg は RASENTRYDLG 構造体の dwError メンバーに、Routing and Remote Access Error Codes または Winerror.h の値を設定する必要があります。
解説(Remarks)
ダイヤルされるエントリの RASENTRY 構造体の szCustomDialDll メンバーがカスタムダイヤル DLL を指定している場合、RAS は RasEntryDlg からこのエントリポイントを呼び出します。
カスタムダイヤル DLL がこのエントリポイントをサポートしていない場合、RAS は RasEntryDlg の呼び出し元に ERROR_NO_CUSTOMENTRYDLG を返します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)