次の方法で共有

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

  • [アーティクル]

GetCost メソッドは、コンピューター全体のインターネット接続の現在のコスト、または接続上の特定の宛先へのルーティングの最初のホップを取得します。 destIPaddr が NULL の場合、このメソッドはコンピューター全体のインターネット接続に使用されるネットワークのコストを返します。

構文

HRESULT GetCost(
  [out] DWORD        *pCost,
  [in]  NLM_SOCKADDR *pDestIPAddr
);

パラメーター

[out] pCost

接続のコストを示す DWORD 値。 最も低い 16 ビットはコスト レベルを表し、最も高い 16 ビットはフラグを表します。 指定できる値は、 NLM_CONNECTION_COST 列挙によって定義されます。

[in] pDestIPAddr

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

戻り値

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

リターン コード 説明
E_POINTER
 pCost が NULL です
E_PENDING
 現在、宛先へのルーティングに使用されるインターフェイスを決定しています
E_INVALIDARG
 destIPAddr で指定された宛先 IPv4/IPv6 アドレスが無効です。
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