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

[アーティクル]
08/25/2023

RasCustomEntryDlg 関数は、サードパーティのカスタムダイヤル DLL によってエクスポートされるアプリケーション定義関数です。この関数を使用すると、サードパーティベンダーは電話帳エントリを管理するためのカスタムダイアログを実装できます。

構文

RasCustomEntryDlgFn Rascustomentrydlgfn;

BOOL Rascustomentrydlgfn(
  HINSTANCE hInstDll,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPRASENTRYDLG lpInfo,
  DWORD dwFlags
)
{...}

パラメーター

hInstDll

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

lpszPhonebook

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

lpszEntry

編集、コピー、または作成する電話帳エントリの名前を含む null で終わる文字列へのポインター。

エントリを編集またはコピーする場合、このパラメーターは既存の電話帳エントリの名前です。エントリをコピーする場合は、RASENTRYDLG 構造体の dwFlags メンバーに RASEDFLAG_CloneEntry フラグを設定します。

エントリを作成する場合、このパラメーターは、ユーザーが変更できる既定の新しいエントリ名です。このパラメーターが NULL の場合、関数は既定の名前を提供します。エントリを作成する場合は、RASENTRYDLG 構造体の dwFlags メンバーに RASEDFLAG_NewEntry フラグを設定します。

lpInfo

追加の入力パラメーターと出力パラメーターを含む RASENTRYDLG 構造体へのポインター。入力時に、この構造体の dwSize メンバーは sizeof( RASENTRYDLG) を指定する必要があります。 dwSize メンバーを使用して、エントリを作成、編集、またはコピーするかどうかを指定します。エラーが発生した場合、 dwError メンバーは エラーコードを返します。それ以外の場合は、0 を返します。

dwFlags

将来利用するために予約されています。

戻り値

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

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

注釈

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

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

要件

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