INetworkCostManager::GetCost-Methode (netlistmgr.h)

Die GetCost-Methode ruft die aktuellen Kosten für eine computerweite Internetverbindung oder den ersten Hop des Routings an ein bestimmtes Ziel einer Verbindung ab. Wenn destIPaddr NULL ist, gibt diese Methode stattdessen die Kosten des Netzwerks zurück, das für die computerweite Internetverbindung verwendet wird.

Syntax

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

Parameter

[out] pCost

Ein DWORD-Wert, der die Kosten der Verbindung angibt. Die niedrigsten 16 Bits stellen die Kostenstufe dar, und die höchsten 16 Bits stellen die Flags dar. Mögliche Werte werden durch die NLM_CONNECTION_COST-Enumeration definiert.

[in] pDestIPAddr

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

Rückgabewert

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

Rückgabecode	Beschreibung
E_POINTER	pCost ist NULL.
E_PENDING	Derzeit wird die Für die Weiterleitung an das Ziel verwendete Schnittstelle bestimmt.
E_INVALIDARG	Die von destIPAddr angegebene IPv4/IPv6-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