Compartilhar via

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

  • Artigo

O método SetDestinationAddresses registra os endereços IPv4/IPv6 de destino especificados para receber notificações de alteração status custo ou plano de dados.

Sintaxe

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

Parâmetros

[in] length

O número de endereços IPv4/IPv6 de destino na lista.

[in] pDestIPAddrList

Uma estrutura NLM_SOCKADDR que contém uma lista de endereços IPv4/IPv6 de destino a serem registrados para custo ou plano de dados status notificação de alteração.

bAppend

Se true, pDestIPAddrList será acrescentado à lista de endereços existente; caso contrário, a lista existente será substituída.

Retornar valor

Retorna S_OK em caso de êxito; caso contrário, um código de erro HRESULT é retornado.

Código de retorno Descrição
E_INVALIDARG
 Retornado se ocorrer um dos seguintes procedimentos:
  • length é 0.
  • length é maior que NLM_MAX_ADDRESS_LIST_SIZE(10)
  • bAppend é VARIANT_TRUE, mas incluir o número de destinos inscritos na lista existente com o valor de length excede NLM_MAX_ADDRESS_SIZE.
  • Um endereço de destino na lista fornecida é inválido.
E_POINTER
 destIPAddrList é NULL.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 A solicitação não terá suporte. Esse erro será retornado se uma pilha IPv4 ou IPv6 não estiver presente no computador local, mas um endereço IPv4 ou IPv6 tiver sido especificado por destIPAddr.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 Esse método foi chamado após o registro de INetworkCostManagerEvents chamando IConnectionPoint::Advise. Consulte Comentário para obter mais informações.

Comentários

Esse método deve ser chamado antes de IConnectionPoint::Advise. Depois que IConnectionPoint::Advise for chamado, esse método não será concluído com êxito até que o último coletor chame IConnectionPoint::UnAdvise. No entanto, esse método pode ser chamado várias vezes antes da chamada para IConnectionPoint::Advise.

Se uma lista de endereços de destino indicados por pDestIPAddrList contiver endereços duplicados, apenas um de cada um será usado para notificar as alterações de custo. Os chamadores podem limpar uma lista de destinos chamando essa função com comprimento definido como 0, destIPAddrList definido NULL e bAppend set FALSE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho netlistmgr.h

Confira também

IConnectionPoint::Advise

IConnectionPoint::UnAdvise

INetworkCostManager