Funzione DrtCreateIpv6UdpTransport (drt.h)

Articolo
08/23/2023

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 e CreateTimerQueue.

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

Condividi tramite