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

Статья
03/05/2024

GetDataPlanStatus извлекает состояние плана данных для подключения к Интернету на уровне компьютера или первого прыжка маршрутизации к определенному назначению при подключении. Если адрес IPv4/IPv6 не указан, этот метод возвращает состояние плана данных подключения, используемого для подключения к Интернету на уровне компьютера.

Синтаксис

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

Параметры

[out] pDataPlanStatus

Указатель на структуру NLM_DATAPLAN_STATUS , которая описывает состояние плана данных, связанного с подключением, используемым для маршрутизации в место назначения. Если destIPAddr указывает адрес туннеля, возвращается первое доступное состояние плана данных в стеке интерфейсов.

[in] pDestIPAddr

Структура NLM_SOCKADDR , содержащая адрес назначения IPv4/IPv6 или туннель. При значении 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
Header	netlistmgr.h

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

INetworkCostManager

NLM_SOCKADDR

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