Win32 API 日本語リファレンス
ホーム › NetworkManagement.Rras › RASPBDLGFUNCA

RASPBDLGFUNCA

コールバック

シグネチャ

void RASPBDLGFUNCA(
    UINT_PTR param0,
    DWORD param1,
    LPSTR param2,
    void* param3
);

パラメーター

フィールド型説明
param0UINT_PTR
param1DWORD
param2LPSTR
param3void*

- dwCallbackId [in]

RasPhonebookDlg 関数に渡された RASPBDLG 構造体の dwCallback メンバーに指定された、アプリケーション定義の値を示します。

- dwEvent [in]

発生したイベントを示すビットフラグのセットです。このパラメーターは次のいずれかの値です。

値 意味
RASPBDEVENT_AddEntry
 ユーザーが新しい電話帳エントリを作成したとき、または既存の電話帳エントリをコピーしたときに受け取ります。pszText パラメーターは、新規に作成またはコピーされたエントリの名前です。pData パラメーターは未定義です。
RASPBDEVENT_EditEntry
 ユーザーが既存の電話帳エントリを変更したときに受け取ります。pszText パラメーターは、変更されたエントリの名前です。pData パラメーターは未定義です。
RASPBDEVENT_RemoveEntry
 ユーザーが電話帳エントリを削除したときに受け取ります。pszText パラメーターは、削除されたエントリの名前です。pData パラメーターは未定義です。
RASPBDEVENT_DialEntry
 ユーザーがエントリへのダイヤルに成功したときに受け取ります。pszText パラメーターは、新たに接続されたエントリの名前です。pData パラメーターは未定義です。
RASPBDEVENT_EditGlobals
 ユーザーが User Preferences(ユーザー設定)プロパティシートで変更を行ったときに受け取ります。pszText パラメーターは、ユーザーが選択した既定の電話帳ファイルのフルパスです。pData パラメーターは未定義です。

このイベントは、 RasPhonebookDlg 呼び出しの lpszPhonebook パラメーターが NULL の場合、ダイアログの起動時にも受け取ります。この場合、イベントは既定の電話帳のパスを呼び出し元に通知します。
RASPBDEVENT_NoUser
 RASPBDFLAG_NoUser フラグが設定されている場合に、ダイアログボックスの初期化中に受け取ります。pData パラメーターは RASNOUSER 構造体へのポインターです。コールバック関数は、この構造体にユーザーのログオン資格情報とダイアログのタイムアウトを設定する必要があります。その後、 RasPhonebookDlg 関数は、指定された資格情報をリモートサーバーによる認証に使用します。pszText パラメーターは未定義です。
RASPBDEVENT_NoUserEdit
 RASPBDFLAG_NoUser フラグが設定されていて、RASPBDEVENT_NoUser イベント中に指定された資格情報をユーザーが変更した場合に受け取ります。pData パラメーターは、更新された資格情報を格納する RASNOUSER 構造体へのポインターです。これは、ダイヤル操作中にユーザーがパスワードを変更した場合や、認証に失敗してユーザーが別の資格情報で認証を再試行した場合に発生します。pszText パラメーターは未定義です。

- pData [in]

追加のバッファー引数へのポインターです。その意味は dwEvent パラメーターで示されるイベントによって異なります。

- pszText [in]

追加の文字列引数へのポインターです。その意味は dwEvent パラメーターで示されるイベントによって異なります。

公式ドキュメント

RasPBDlgFunc 関数は、 RasPhonebookDlg ダイアログボックスが開いている間、ユーザーの操作に関する通知を受け取るアプリケーション定義のコールバック関数です。

解説(Remarks)

メモ

rasdlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして RASPBDLGFUNC を定義します。エンコードに依存しないこのエイリアスを、エンコードに依存するコードと混在させると、不一致が生じ、コンパイルエラーや実行時エラーの原因となることがあります。詳細については、Conventions for Function Prototypes を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)