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

RasDialFunc2 コールバック関数は、リモート アクセス接続プロセス中に状態の変更が発生したときに RasDial 関数によって呼び出されます。 RasDialFunc2 関数は RasDialFunc1 コールバック関数に似ていますが、マルチリンク接続に関する追加情報が提供される点が除きます。

構文

RASDIALFUNC2 Rasdialfunc2;

DWORD Rasdialfunc2(
  ULONG_PTR unnamedParam1,
  DWORD unnamedParam2,
  HRASCONN unnamedParam3,
  UINT unnamedParam4,
  tagRASCONNSTATE unnamedParam5,
  DWORD unnamedParam6,
  DWORD unnamedParam7
)
{...}

パラメーター

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

unnamedParam6

unnamedParam7

戻り値

RasDialFunc2 関数が 0 以外の値を返した場合、RasDial はコールバック通知を送信し続けます。

RasDialFunc2 関数が 0 を返した場合、RasDial はすべてのサブエントリに対するコールバック通知の送信を停止します。

注釈

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

RasDialFunc2 の実装は、プラットフォームによって異なる可能性があるため、特定の RASCONNSTATE 接続状態の順序や発生に依存しないでください。

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

メモ便宜上、RasDialFunc2 コールバック関数内から RasHangUp を呼び出すことができます。 ただし、ハングアップ処理の多くは、 RasDialFunc2 コールバック関数が返された後に発生します。
 
メモRasDialFunc2 は、アプリケーション定義またはライブラリ定義関数名のプレースホルダーです。
 

要件

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

こちらもご覧ください

RASCONNSTATE

Rasdial

RasDialFunc

RasDialFunc1

RasEnumConnections

RasEnumEntries

RasGetConnectStatus

RasGetErrorString

RasHangUp

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

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