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

RASPBDLGFUNCW

コールバック

シグネチャ

void RASPBDLGFUNCW(
    UINT_PTR param0,
    DWORD param1,
    LPWSTR param2,
    void* param3
);

パラメーター

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

- dwCallbackId [in]

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

- dwEvent [in]

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

値 意味
RASPBDEVENT_AddEntry
 ユーザーが新しい電話帳エントリを作成したとき、または既存の電話帳エントリをコピーしたときに受け取ります。pszText パラメーターは、新規または複製されたエントリの名前です。pData パラメーターは未定義です。
RASPBDEVENT_EditEntry
 ユーザーが既存の電話帳エントリを変更したときに受け取ります。pszText パラメーターは、変更されたエントリの名前です。pData パラメーターは未定義です。
RASPBDEVENT_RemoveEntry
 ユーザーが電話帳エントリを削除したときに受け取ります。pszText パラメーターは、削除されたエントリの名前です。pData パラメーターは未定義です。
RASPBDEVENT_DialEntry
 ユーザーがエントリへのダイヤルに成功したときに受け取ります。pszText パラメーターは、新しく接続されたエントリの名前です。pData パラメーターは未定義です。
RASPBDEVENT_EditGlobals
 ユーザーが [ユーザー設定] プロパティ シートで変更を行ったときに受け取ります。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 を定義します。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させると、不一致が生じ、コンパイル エラーや実行時エラーの原因となる可能性があります。詳細については、関数プロトタイプの規則 を参照してください。

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