RasCustomDialDlgFn コールバック関数 (rasdlg.h)

  • [アーティクル]

[この関数は、Windows Server 2008 の時点では使用できません。

]

RasCustomDialDlg 関数は、サードパーティのカスタム ダイヤル DLL によってエクスポートされるアプリケーション定義関数です。 この関数を使用すると、サードパーティベンダーはカスタム RAS 接続ダイアログ ボックスを実装できます。

構文

RasCustomDialDlgFn Rascustomdialdlgfn;

BOOL Rascustomdialdlgfn(
  HINSTANCE hInstDll,
  DWORD dwFlags,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPWSTR lpszPhoneNumber,
  LPRASDIALDLG lpInfo,
  PVOID pvInfo
)
{...}

パラメーター

hInstDll

読み込まれたカスタム ダイヤル DLL のインスタンスを処理します。

dwFlags

RasCustomDialDlg オプションを指定するビット フラグのセット。

値 意味
RCD_Logon
 このフラグが 1 に設定されている場合、接続は Windows ログオン コンテキストからダイヤルされました。 RasDial はこの情報を使用して、接続エントリの適切なユーザー設定を取得します。 このエントリ ポイントから RasDial が呼び出された場合、lpRasDialExtension パラメーターの dwfOptions メンバーには、接続が Windows ログオン コンテキストからダイヤルされたことを示すRDEOPT_NoUser フラグが設定されている必要があります。
 

Windows Server 2003 および Windows XP/2000: このパラメーターは予約されているため、使用しないでください。

lpszPhonebook

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

lpszEntry

ダイヤルする電話帳エントリの名前を含む null で終わる文字列へのポインター。

lpszPhoneNumber

電話帳エントリに格納されている番号をオーバーライドする電話番号を含む null で終わる文字列へのポインター。 このパラメーターが NULL の場合、 RasDialDlg は電話帳エントリの番号を使用します。

lpInfo

追加の入力パラメーターと出力パラメーターを含む RASDIALDLG 構造体へのポインター。 入力時に、この構造体の dwSize メンバーは sizeof( RASDIALDLG) を指定する必要があります。 エラーが発生した場合、 dwError メンバーはエラー コードを返します。それ以外の場合は、0 を返します。

pvInfo

内部使用のために予約されています。 このパラメーターは常に NULL になります。

戻り値

ユーザーが電話帳エントリを作成、コピー、または編集する場合、戻り値は TRUE である必要があります。 それ以外の場合、関数は FALSE を返す必要があります。

エラーが発生した場合、RasCustomEntryDlg は RASENTRYDLG 構造体の dwError メンバーを、ルーティングとリモート アクセスのエラー コードまたは Winerror.h の値に設定する必要があります。

注釈

RAS は、ダイヤルされるエントリの RASENTRY 構造体の szCustomDialDll メンバーがカスタム ダイヤル DLL を指定している場合、RasDialDlg からこのエントリ ポイントを呼び出します。

このエントリ ポイントが RasDial を呼び出す場合、lpRasDialExtensions パラメーターは NULL にすることはできません。RASDIALEXTENSIONS 構造体の dwfOptions メンバーには、RDEOPT_CustomDial フラグが設定されている必要があります。

カスタム ダイヤル ダイアログでは、LOWORD(wParam) が IDCANCEL と等しいWM_COMMAND メッセージをサポートする必要があります。

カスタム ダイヤル DLL がこのエントリ ポイントをサポートしていない場合、RAS は RasDialDlg の呼び出し元にERROR_CANNOT_DO_CUSTOMDIALを返します。

要件

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

こちらもご覧ください

カスタム ダイヤラー

RASENTRY

RasCustomDial

RasCustomEntryDlg

RasCustomHangUp

RasDialDlg

リモート アクセス サービス (RAS) の概要

リモート アクセス サービス関数