Метод INetworkCostManager::GetCost (netlistmgr.h)

Статья
02/29/2024

Метод GetCost извлекает текущие затраты на подключение к Интернету на уровне компьютера или первый прыжок маршрутизации к определенному назначению по подключению. Если destIPaddr имеет значение NULL, этот метод возвращает стоимость сети, используемой для подключения к Интернету на уровне компьютера.

Синтаксис

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

Параметры

[out] pCost

Значение DWORD, указывающее стоимость подключения. Самые низкие 16 бит представляют уровень затрат, а самые высокие 16 бит — флаги. Возможные значения определяются перечислением NLM_CONNECTION_COST .

[in] pDestIPAddr

Структура NLM_SOCKADDR , содержащая адрес назначения IPv4/IPv6. При значении NULL этот метод возвращает затраты, связанные с предпочитаемым подключением, используемым для подключения компьютера к Интернету.

Возвращаемое значение

Возвращает S_OK при успешном выполнении, в противном случае возвращается код ошибки HRESULT.

Код возврата	Описание
E_POINTER	pCost имеет значение NULL
E_PENDING	В настоящее время определяется интерфейс, используемый для маршрутизации в место назначения
E_INVALIDARG	Недопустимый адрес назначения IPv4/IPv6, указанный destIPAddr .
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Запрос не поддерживается. Эта ошибка возвращается, если на локальном компьютере отсутствует стек IPv4 или IPv6, но адрес IPv4 или IPv6 был указан destIPAddr.
HRESULT_FROM_WIN32(ERROR_NO_NETWORK)	Сетевое подключение сейчас недоступно.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	netlistmgr.h

См. также раздел

INetworkCostManager

NLM_SOCKADDR

Поделиться через