INetworkCostManager::SetDestinationAddresses-Methode (netlistmgr.h)

Artikel
03/04/2024

Die SetDestinationAddresses-Methode registriert die angegebenen IPv4-/IPv6-Zieladressen, um Kosten- oder Datenplan-status Änderungsbenachrichtigungen zu empfangen.

Syntax

HRESULT SetDestinationAddresses(
  [in] UINT32       length,
  [in] NLM_SOCKADDR *pDestIPAddrList,
       VARIANT_BOOL bAppend
);

Parameter

[in] length

Die Anzahl der IPv4/IPv6-Zieladressen in der Liste.

[in] pDestIPAddrList

Eine NLM_SOCKADDR-Struktur, die eine Liste der IPv4/IPv6-Zieladressen enthält, die für kosten- oder datenplan- status Änderungsbenachrichtigung registriert werden sollen.

bAppend

Bei true wird pDestIPAddrList an die vorhandene Adressliste angefügt. Andernfalls wird die vorhandene Liste überschrieben.

Rückgabewert

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

Rückgabecode	Beschreibung
E_INVALIDARG	Wird zurückgegeben, wenn einer der folgenden Fehler auftritt: length ist 0. Die Länge ist größer als NLM_MAX_ADDRESS_LIST_SIZE(10) bAppend ist VARIANT_TRUE, aber die Anzahl der abonnierten Ziele in der vorhandenen Liste mit dem Wert der Länge übersteigt NLM_MAX_ADDRESS_SIZE. Eine Zieladresse in der angegebenen Liste ist ungültig.
E_POINTER	destIPAddrList ist NULL.
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_ALREADY_INITIALIZED)	Diese Methode wurde nach der Registrierung für INetworkCostManagerEvents durch Aufrufen von IConnectionPoint::Advise aufgerufen. Weitere Informationen finden Sie unter Hinweis.

Hinweise

Diese Methode muss vor IConnectionPoint::Advise aufgerufen werden. Nachdem IConnectionPoint::Advise aufgerufen wurde, wird diese Methode erst erfolgreich abgeschlossen, wenn die letzte Senke IConnectionPoint::UnAdvise aufruft. Diese Methode kann jedoch vor dem Aufruf von IConnectionPoint::Advise mehrmals aufgerufen werden.

Wenn eine Liste von Zieladressen, die durch pDestIPAddrList angegeben wird, doppelte Adressen enthält, wird nur eine von ihnen verwendet, um Kostenänderungen zu benachrichtigen. Aufrufer können eine Liste von Zielen löschen, indem sie diese Funktion aufrufen, wobei die Länge auf 0, destIPAddrList null und bAppend false festgelegt ist.

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

IConnectionPoint::Advise

IConnectionPoint::UnAdvise

INetworkCostManager

Freigeben über