IsDestinationReachableA 関数 (sensapi.h)

  • [アーティクル]

IsDestinationReachable 関数は、指定した宛先に到達できるかどうかを判断し、宛先の接続品質 (QOC) 情報を提供します。

Windows Vista 以降、Windows Server 2008 以降: この関数はサポートされておらず、常に ERROR_CALL_NOT_IMPLEMENTEDを返します。

構文

BOOL IsDestinationReachableA(
  [in]      LPCSTR    lpszDestination,
  [in, out] LPQOCINFO lpQOCInfo
);

パラメーター

[in] lpszDestination

変換先を指定する null で終わる文字列へのポインター。 宛先には、IP アドレス、UNC 名、または URL を指定できます。

[in, out] lpQOCInfo

接続品質 ( QOC ) 情報を受け取る QOCINFO 構造体へのポインター。 QOC 情報を受信しない場合は、 NULL ポインターを指定できます。

戻り値

リターン コード 説明
TRUE
 宛先に到達できます。
FALSE
 宛先に到達できません。 詳細なエラー情報を得るには、GetLastError を呼び出します。
ERROR_CALL_NOT_IMPLEMENTED
 この関数は、Windows Vista では使用できません。

注釈

クライアント アプリケーションでは、ネットワーク操作を続行する前に、この関数を使用して QOC 情報を決定します。 ネットワーク カードまたはリモート アクセス サーバー (RAS) を介してネットワークに直接接続されているスタンドアロン コンピューターの場合、この関数は、最も近いルーターへの RPC 呼び出しで最小限のネットワーク トラフィックを生成します。 RAS またはネットワーク ゲートウェイを使用して宛先に到達できるネットワークの一部であるコンピューターの場合、この関数は宛先に ping を実行して正確な QOC 情報を生成します。

この関数は、TCP/IP 接続でのみ使用できます。 呼び出し元は QOCINFO 構造体のバッファーを提供し、不要な場合はメモリを解放する必要があります。

Windows Vista および Windows Server 2008 用に設計されたアプリケーション以降、開発者はこの関数ではなく ネットワーク リスト マネージャー の使用を検討する必要があります。

注意

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

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー sensapi.h
Library Sensapi.lib
[DLL] Sensapi.dll

こちらもご覧ください

システム イベント通知サービスについて

IsNetworkAlive

QOCINFO