INetworkCostManager::GetDataPlanStatus-Methode (netlistmgr.h)

GetDataPlanStatus ruft den Datenplan status für eine computerweite Internetverbindung oder den ersten Hop des Routings an ein bestimmtes Ziel einer Verbindung ab. Wenn keine IPv4/IPv6-Adresse angegeben ist, gibt diese Methode den Datenplan status der Verbindung zurück, die für die computerweite Internetverbindung verwendet wird.

Syntax

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

Parameter

[out] pDataPlanStatus

Zeiger auf eine NLM_DATAPLAN_STATUS-Struktur, die den Datenplan status beschreibt, der einer Verbindung zugeordnet ist, die zum Weiterleiten an ein Ziel verwendet wird. Wenn destIPAddr eine Tunneladresse angibt, wird der erste verfügbare Datenplan status im Schnittstellenstapel zurückgegeben.

[in] pDestIPAddr

Eine NLM_SOCKADDR-Struktur , die die IPv4/IPv6-Zieladresse oder die Tunneladresse enthält. Wenn NULL, gibt diese Methode die Kosten für die bevorzugte Verbindung zurück, die für die Computerinternetverbindung verwendet wird.

Rückgabewert

Gibt S_OK bei Erfolg zurück, andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode	Beschreibung
E_POINTER	pDataPlanStatus ist NULL.
E_PENDING	Bestimmen der Schnittstelle, die zum Weiterleiten an das Ziel verwendet wird
E_INVALIDARG	Die von destIPAddr angegebene Zieladresse ist ungültig.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Die Anforderung wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn entweder ein IPv4- oder IPv6-Stapel auf dem lokalen Computer nicht vorhanden ist, aber entweder eine IPv4- oder IPv6-Adresse von destIPAddr angegeben wurde.
HRESULT_FROM_WIN32(ERROR_NO_NETWORK)	Die Netzwerkkonnektivität ist derzeit nicht verfügbar.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	netlistmgr.h

Weitere Informationen

INetworkCostManager

NLM_SOCKADDR