RasCustomDialDlgFn
コールバックシグネチャ
BOOL RasCustomDialDlgFn(
HINSTANCE hInstDll,
DWORD dwFlags,
LPWSTR lpszPhonebook,
LPWSTR lpszEntry,
LPWSTR lpszPhoneNumber,
RASDIALDLG* lpInfo,
void* pvInfo
);パラメーター
| フィールド | 型 | 説明 | ||||
|---|---|---|---|---|---|---|
| hInstDll | HINSTANCE | 読み込まれたカスタムダイヤル DLL のインスタンスへのハンドルです。 | ||||
| dwFlags | DWORD | RasCustomDialDlg のオプションを指定するビットフラグのセットです。
Windows Server 2003 および Windows XP/2000: このパラメーターは予約されており、使用しないでください。 | ||||
| lpszPhonebook | LPWSTR | 電話帳 (PBK) ファイルのフルパスとファイル名を指定する null 終端文字列へのポインターです。このパラメーターが NULL の場合、この関数は現在の既定の電話帳ファイルを使用します。既定の電話帳ファイルは、ダイヤルアップ ネットワーク ダイアログボックスの ユーザー設定 プロパティシートでユーザーが選択したものです。 | ||||
| lpszEntry | LPWSTR | ダイヤルする電話帳エントリの名前を格納した null 終端文字列へのポインターです。 | ||||
| lpszPhoneNumber | LPWSTR | 電話帳エントリに格納されている番号を上書きする電話番号を格納した null 終端文字列へのポインターです。このパラメーターが NULL の場合、 RasDialDlg は電話帳エントリ内の番号を使用します。 | ||||
| lpInfo | RASDIALDLG* | 追加の入力パラメーターおよび出力パラメーターを格納した RASDIALDLG 構造体へのポインターです。入力時には、この構造体の dwSize メンバーに sizeof( RASDIALDLG) を指定する必要があります。エラーが発生した場合、dwError メンバーにはエラーコードが返されます。それ以外の場合は 0 が返されます。 | ||||
| pvInfo | void* | 内部使用のために予約されています。このパラメーターは常に NULL です。 |
公式ドキュメント
[この関数は Windows Server 2008 以降では使用できません。
]
RasCustomDialDlg 関数は、サードパーティ製のカスタムダイヤル DLL によってエクスポートされる、アプリケーション定義の関数です。この関数により、サードパーティのベンダーは独自の RAS 接続ダイアログボックスを実装できます。
戻り値
ユーザーが電話帳エントリを作成、コピー、または編集した場合、戻り値は TRUE にする必要があります。それ以外の場合、この関数は FALSE を返す必要があります。
エラーが発生した場合、 RasCustomEntryDlg は RASENTRYDLG 構造体の dwError メンバーに、ルーティングとリモート アクセスのエラーコードまたは Winerror.h の値を設定する必要があります。
解説(Remarks)
ダイヤル対象のエントリの RASENTRY 構造体の szCustomDialDll メンバーがカスタムダイヤル DLL を指定している場合、RAS は RasDialDlg からこのエントリポイントを呼び出します。
このエントリポイントから RasDial を呼び出す場合、lpRasDialExtensions パラメーターを NULL にすることはできません。また、 RASDIALEXTENSIONS 構造体の dwfOptions メンバーに RDEOPT_CustomDial フラグを設定する必要があります。
カスタムダイヤルダイアログは、 LOWORD(wParam) が IDCANCEL と等しい WM_COMMAND メッセージをサポートする必要があります。
カスタムダイヤル DLL がこのエントリポイントをサポートしていない場合、RAS は RasDialDlg の呼び出し元に ERROR_CANNOT_DO_CUSTOMDIAL を返します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)