Método INetworkCostManager::SetDestinationAddresses (netlistmgr.h)

El método SetDestinationAddresses registra las direcciones IPv4/IPv6 de destino especificadas para recibir notificaciones de cambio de estado del plan de datos o costo.

Sintaxis

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

Parámetros

[in] length

Número de direcciones IPv4/IPv6 de destino en la lista.

[in] pDestIPAddrList

Estructura de NLM_SOCKADDR que contiene una lista de direcciones IPv4/IPv6 de destino para registrarse para la notificación de cambio de estado del plan de datos o costo.

bAppend

Si es true, pDestIPAddrList se anexará a la lista de direcciones existente; de lo contrario, se sobrescribirá la lista existente.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente; de lo contrario, se devuelve un código de error HRESULT.

Código devuelto	Descripción
E_INVALIDARG	Se devuelve si se produce una de las siguientes acciones: length es 0. length es mayor que NLM_MAX_ADDRESS_LIST_SIZE(10) bAppend es VARIANT_TRUE, pero incluye el número de destinos suscritos en la lista existente con el valor de longitud superior a NLM_MAX_ADDRESS_SIZE. Una dirección de destino de la lista proporcionada no es válida.
E_POINTER	destIPAddrList es NULL.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	No se admite la solicitud. Este error se devuelve si una pila IPv4 o IPv6 no está presente en el equipo local, pero se especificó una dirección IPv4 o IPv6 mediante destIPAddr.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Se llamó a este método después de registrarse para INetworkCostManagerEvents llamando a IConnectionPoint::Advise. Vea Comentarios para obtener más información.

Comentarios

Se debe llamar a este método antes de IConnectionPoint::Advise. Una vez que se llama a IConnectionPoint::Advise , este método no se completará correctamente hasta que el último receptor llame a IConnectionPoint::UnAdvise. Sin embargo, se puede llamar a este método varias veces antes de la llamada a IConnectionPoint::Advise.

Si una lista de direcciones de destino indicadas por pDestIPAddrList contiene direcciones duplicadas, solo se usará una de cada una para notificar los cambios de costos. Los autores de llamadas pueden borrar una lista de destinos llamando a esta función con longitud establecida en 0, destIPAddrList establecido en NULL y bAppend establecido en FALSE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	netlistmgr.h

Consulte también

IConnectionPoint::Advise

IConnectionPoint::UnAdvise

INetworkCostManager