Funzione DrtCreateIpv6UdpTransport (drt.h)

  • Articolo

La funzione DrtCreateIpv6UdpTransport crea un trasporto basato sul protocollo UDP IPv6.

Sintassi

HRESULT DrtCreateIpv6UdpTransport(
            DRT_SCOPE      scope,
            ULONG          dwScopeId,
            ULONG          dwLocalityThreshold,
  [in, out] USHORT         *pwPort,
  [out]     HDRT_TRANSPORT *phTransport
);

Parametri

scope

Enumerazione DRT_SCOPE che specifica l'ambito IPv6 in cui deve essere eseguito il DRT.

dwScopeId

Identificatore che specifica in modo univoco l'interfaccia a cui è associato l'ambito.

Per l'ambito globale questo parametro è sempre l'ID "GLOBAL_" ed è facoltativo quando si usa solo l'ambito globale. Per l'ambito locale del collegamento, questo parametro rappresenta l'interfaccia associata alla scheda di interfaccia di rete in cui è presente l'ambito locale del collegamento.

dwLocalityThreshold

Identificatore che specifica la modalità di utilizzo delle informazioni sulla località in base agli indirizzi IpV6 durante la memorizzazione nella cache degli elementi adiacenti. Per impostazione predefinita, DRT assegna la preferenza ai vicini con un indirizzo IPv6 con un prefisso in comune con il computer locale.

[in, out] pwPort

Puntatore alla porta utilizzata dall'istanza DRT locale.

[out] phTransport

Puntatore a un handle di trasporto DRT specificato nella struttura DRT_SETTINGS .

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono:

Codice restituito Descrizione
E_OUTOFMEMORY
 Il sistema non può allocare memoria per il provider.
DRT_E_INVALID_PORT
 pwPort è NULL.
DRT_E_INVALID_TRANSPORT_PROVIDER
 hTransport è NULL.
DRT_E_INVALID_SCOPE
 L'ambito specificato non è DRT_GLOBAL_SCOPE, DRT_SITE_LOCAL_SCOPE o DRT_LINK_LOCAL_SCOPE.
DRT_E_TRANSPORT_UNEXPECTED
 Si è verificato un errore imprevisto. Per motivi, vedere TraceError.
 
Nota Questa funzione può anche restituire errori dalle chiamate sottostanti a NotifyUnicastIpAddressChange,WSAStartup, GetAdaptersAddresses, setsockopt, WSASocket, Bind, WSAIoctl, CreateThreadpoolIo, CreateThreadpoolCleanupGroup eCreateTimerQueue.
 

Commenti

Il trasporto UDP IPv6 predefinito creato da questa funzione è specifico di DRT per cui viene creato. Di conseguenza, non può essere riutilizzato tra più drT.

Quando si usa l'API Tabella di routing distribuito in Windows XP con Service Pack 2 (SP2), è necessario abilitare il supporto del protocollo IPv6 per la creazione di un trasporto tramite DrtCreateIpv6UdpTransport .

Requisiti

   
Client minimo supportato Windows 7 Professional [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione drt.h
Libreria Drttransport.lib
DLL Drt.dll

Vedi anche

DRT_SETTINGS

DrtDeleteIpv6UdpTransport