RASADFUNCA コールバック関数 (ras.h)

RASADFunc 関数は、自動ダイアログ用にカスタマイズされたユーザー インターフェイスを提供するために使用されるアプリケーション定義のコールバック関数です。

構文

RASADFUNCA Rasadfunca;

BOOL Rasadfunca(
  LPSTR unnamedParam1,
  LPSTR unnamedParam2,
  LPRASADPARAMS unnamedParam3,
  LPDWORD unnamedParam4
)
{...}

パラメーター

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

戻り値

アプリケーションがダイヤル操作を実行する場合は、 TRUE を返します。 ダイヤル操作の結果を示すには、 lpdwRetCode パラメーターを使用します。

アプリケーションがダイヤル操作を実行しない場合は、 FALSE を返します。 この場合、システムはダイヤルに既定のユーザー インターフェイスを使用します。

注釈

システムは、カスタム AutoDial ハンドラーを使用して電話帳エントリの AutoDial 操作を開始すると、指定された RASADFunc を呼び出します。 RASADFunc は、カスタム ダイヤル操作を実行するスレッドを開始できます。 RASADFunc 関数は、ダイヤルを引き継いだことを示す場合は TRUE を返し、システムがダイヤルを実行できるようにするには FALSE を返します。

RASADFunc 関数は、ダイヤル操作を実行する場合は、ダイヤル用の独自のユーザー インターフェイスを提示し、RasDial 関数を呼び出して実際のダイヤルを実行します。 その後 、RASADFuncTRUE を 返して、ダイヤルを引き継いだことを示します。 ダイヤル操作が完了したら、 lpdwRetCode パラメーターが指す変数を設定して、成功または失敗を示します。

AutoDial DLL は 、RASADFUNCA (ANSI) と RASADFUNCW (Unicode) バージョンの両方の RASADFunc ハンドラーを提供する必要があります。 電話帳エントリに対して RASADFunc AutoDial ハンドラーを有効にするには、RasSetEntryProperties 関数の呼び出しで RASENTRY 構造体を使用します。 szAutodialDll メンバーはハンドラーを含む DLL の名前を指定し、szAutodialFunc メンバーはハンドラーのエクスポートされた名前を指定します。 szAutodialFunc メンバーには、"A" または "W" サフィックスを含めてはなりません。

RASADFunc は、ライブラリ定義関数名のプレースホルダーです。 RASADFUNC 型は、RASADFunc 関数へのポインターです。

注意

ras.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RASADFUNC を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

こちらもご覧ください

RASENTRY

Rasdial

RasSetEntryProperties

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

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