INetworkCostManager::GetDataPlanStatus メソッド (netlistmgr.h)

GetDataPlanStatus は、コンピューター全体のインターネット接続のデータ プランの状態、または接続上の特定の宛先へのルーティングの最初のホップを取得します。 IPv4/IPv6 アドレスが指定されていない場合、このメソッドはコンピューター全体のインターネット接続に使用される接続のデータ プランの状態を返します。

構文

HRESULT GetDataPlanStatus(
  [out] NLM_DATAPLAN_STATUS *pDataPlanStatus,
  [in]  NLM_SOCKADDR        *pDestIPAddr
);

パラメーター

[out] pDataPlanStatus

宛先へのルーティングに使用される接続に関連付けられているデータ プランの状態を記述する NLM_DATAPLAN_STATUS構造体への ポインター。 destIPAddr でトンネル アドレスが指定されている場合は、インターフェイス スタックで最初に使用可能なデータ プランの状態が返されます。

[in] pDestIPAddr

宛先 IPv4/IPv6 またはトンネル アドレスを含む NLM_SOCKADDR 構造体。 NULL の場合、このメソッドはマシンのインターネット接続に使用される優先接続に関連付けられているコストを返します。

戻り値

成功したS_OKを返します。それ以外の場合は、HRESULT エラー コードが返されます。

リターン コード	説明
E_POINTER	pDataPlanStatus は NULL です。
E_PENDING	宛先へのルーティングに使用されるインターフェイスの決定
E_INVALIDARG	destIPAddr で指定された宛先アドレスが無効です。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	要求はサポートされていません。 このエラーは、IPv4 または IPv6 スタックがローカル コンピューターに存在せず、iPv4 または IPv6 アドレスが destIPAddr で指定されている場合に返されます。
HRESULT_FROM_WIN32(ERROR_NO_NETWORK)	ネットワーク接続は現在使用できません。

要件

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

こちらもご覧ください

INetworkCostManager

NLM_SOCKADDR