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

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

RasDialFunc1 関数は、リモートアクセス接続プロセス中に状態の変更が発生したときに、RasDial 関数によって呼び出されます。 RasDialFunc1 関数は RasDialFunc 関数に相当しますが、RAS 接続へのハンドルと拡張エラーコードという 2 つのパラメーターを追加することで拡張されます。

構文

RASDIALFUNC1 Rasdialfunc1;

void Rasdialfunc1(
  HRASCONN unnamedParam1,
  UINT unnamedParam2,
  tagRASCONNSTATE unnamedParam3,
  DWORD unnamedParam4,
  DWORD unnamedParam5
)
{...}

パラメーター

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

戻り値

なし

解説

RasDialFunc1 コールバック関数の呼び出し中に、RasDial 接続操作が中断されます。そのため、 RasDialFunc1 の実装は通常、できるだけ早くを返します。このルールには 2 つの例外があります。モデムなどの非同期 (低速) デバイスには、多くの場合、タイムアウト期間がミリ秒ではなく秒単位で測定されます。 通常、RasDialFunc1 関数からの低速な戻りは問題ではありません。 dwError が 0 以外の場合、エラーが発生したことを示すプロンプトの戻り要件も適用されません。たとえば、エラーダイアログボックスを表示し、ユーザー入力を待つのは安全です。

RasDialFunc1 の実装は、プラットフォームによって異なる可能性があるため、特定の RASCONNSTATE 接続状態の順序や発生に依存しないようにする必要があります。

RasDialFunc1 コールバック関数内から RasDial 関数を呼び出さないでください。コールバック関数内から RasGetConnectStatus、 RasEnumEntries、 RasEnumConnections、 RasGetErrorString、および RasHangUp 関数を呼び出します。たとえば、コールバック関数内から RasGetConnectStatus を 呼び出すと、接続しているデバイスの名前と種類を判断するのに役立ちます。

便宜上、RasDialFunc1 コールバック関数内から RasHangUp を呼び出すことができます。ただし、ハングアップ処理の多くは 、RasDialFunc1 コールバック関数が返された後に発生します。

RasDialFunc1 は、アプリケーション定義またはライブラリ定義関数名のプレースホルダーです。

要件

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