Metodo INetworkCostManager::SetDestinationAddresses (netlistmgr.h)

  • Articolo

Il metodo SetDestinationAddresses registra gli indirizzi IPv4/IPv6 di destinazione specificati per ricevere notifiche di modifica dello stato del piano dati o costi.

Sintassi

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

Parametri

[in] length

Numero di indirizzi IPv4/IPv6 di destinazione nell'elenco.

[in] pDestIPAddrList

Struttura NLM_SOCKADDR contenente un elenco di indirizzi IPv4/IPv6 di destinazione da registrare per la notifica di modifica dello stato del piano dati o dei costi.

bAppend

Se true, pDestIPAddrList verrà aggiunto all'elenco indirizzi esistente; in caso contrario, l'elenco esistente verrà sovrascritto.

Valore restituito

Restituisce S_OK in caso di esito positivo, in caso contrario viene restituito un codice di errore HRESULT.

Codice restituito Descrizione
E_INVALIDARG
 Restituito se si verifica uno dei seguenti:
  • la lunghezza è 0.
  • lunghezza maggiore di NLM_MAX_ADDRESS_LIST_SIZE(10)
  • bAppend è VARIANT_TRUE, ma incluso il numero di destinazioni sottoscritte nell'elenco esistente con il valore di lunghezza supera NLM_MAX_ADDRESS_SIZE.
  • Un indirizzo di destinazione nell'elenco fornito non è valido.
E_POINTER
 destIPAddrList è NULL.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 La richiesta non è supportata. Questo errore viene restituito se non è presente uno stack IPv4 o IPv6 nel computer locale, ma un indirizzo IPv4 o IPv6 è stato specificato da destIPAddr.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 Questo metodo è stato chiamato dopo la registrazione per INetworkCostManagerEvents chiamando IConnectionPoint::Advise. Per altre informazioni, vedere Osservazioni.

Commenti

Questo metodo deve essere chiamato prima di IConnectionPoint::Advise. Una volta chiamato IConnectionPoint::Advise , questo metodo non verrà completato fino all'ultimo sink chiama IConnectionPoint::UnAdvise. Tuttavia, questo metodo può essere chiamato più volte prima della chiamata a IConnectionPoint::Consiglia.

Se un elenco di indirizzi di destinazione indicati da pDestIPAddrList contiene indirizzi duplicati, verrà usato solo uno di essi per notificare le modifiche ai costi. I chiamanti possono cancellare un elenco di destinazioni chiamando questa funzione con lunghezza impostata su 0, destIPAddrList set NULL e bAppend set FALSE.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Nessuno supportato
Piattaforma di destinazione Windows
Intestazione netlistmgr.h

Vedi anche

IConnectionPoint::Consigli

IConnectionPoint::UnAdvise

INetworkCostManager