ORASADFUNC
コールバックシグネチャ
BOOL ORASADFUNC(
HWND param0,
LPSTR param1,
DWORD param2,
DWORD* param3
);パラメーター
| フィールド | 型 | 説明 |
|---|---|---|
| param0 | HWND | |
| param1 | LPSTR | |
| param2 | DWORD | |
| param3 | DWORD* | - dwFlags [in]予約済みです。0 を指定する必要があります。 - hwndOwner [in]オーナーウィンドウのハンドルです。 - lpdwRetCode [in]ダイヤル操作の結果をコールバック関数が格納する変数へのポインターです。ダイヤル操作が成功した場合は、この変数に ERROR_SUCCESS を設定します。ダイヤル操作が失敗した場合は、0 以外の値を設定します。 - lpszEntry [in]使用する電話帳エントリを指定する、null で終わる文字列へのポインターです。 |
公式ドキュメント
ORASADFunc 関数は、自動ダイヤル用のカスタマイズされたユーザーインターフェイスを提供するために使用される、アプリケーション定義のコールバック関数です。
このプロトタイプは、以前のバージョンの Windows との互換性のために提供されています。新しいアプリケーションでは、 RASADFunc コールバック関数を使用してください。このプロトタイプのサポートは、将来のバージョンの RAS では削除される可能性があります。
戻り値
コールバック関数がダイヤル操作を実行する場合は、TRUE を返します。ダイヤル操作の結果を示すには、lpdwRetCode パラメーターを使用します。
コールバック関数がダイヤル操作を実行しない場合は、FALSE を返します。この場合、システムはダイヤル用の既定のユーザーインターフェイスを使用します。
解説(Remarks)
ORASADFunc 関数がダイヤル操作を実行する場合、この関数は独自のダイヤル用ユーザーインターフェイスを表示し、実際のダイヤルを行うために RasDial 関数を呼び出します。その後、 ORASADFunc は TRUE を返して、ダイヤルを引き受けたことを示します。ダイヤル操作が完了したら、lpdwRetCode が指す変数に成功または失敗を設定します。
電話帳エントリに対して ORASADFunc ハンドラーを有効にするには、 RasSetEntryProperties 関数の呼び出しで RASENTRY 構造体を使用します。szAutodialDll メンバーはハンドラーを含む DLL の名前を指定し、szAutodialDll メンバーはハンドラーのエクスポート名を指定します。
ORASADFunc 関数は、ライブラリ定義の関数名のプレースホルダーです。ORASADFUNC 型は ORASADFunc 関数へのポインターです。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)