DrtCreateIpv6UdpTransport, fonction (drt.h)

Article
08/23/2023

La fonction DrtCreateIpv6UdpTransport crée un transport basé sur le protocole UDP IPv6.

Syntaxe

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

Paramètres

scope

Le DRT_SCOPE énumération qui spécifie l’étendue IPv6 dans laquelle la DRT doit fonctionner.

dwScopeId

Identificateur qui spécifie de manière unique l’interface à laquelle l’étendue est associée.

Pour l’étendue globale, ce paramètre est toujours l’ID « GLOBAL_ » et est facultatif lorsque vous utilisez uniquement l’étendue globale. Pour l’étendue locale de lien, ce paramètre représente l’interface associée à la carte d’interface réseau sur laquelle l’étendue locale de lien existe.

dwLocalityThreshold

Identificateur qui spécifie comment les informations de localité basées sur les adresses IpV6 sont utilisées lors de la mise en cache des voisins. Par défaut, la DRT donne la préférence aux voisins qui ont une adresse IPv6 avec un préfixe commun avec l’ordinateur local.

[in, out] pwPort

Pointeur vers le port utilisé par le instance DRT local.

[out] phTransport

Pointeur vers un handle de transport DRT spécifié dans la structure DRT_SETTINGS .

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. D’autres valeurs possibles sont les suivantes :

Code de retour	Description
E_OUTOFMEMORY	Le système ne peut pas allouer de mémoire au fournisseur.
DRT_E_INVALID_PORT	pwPort a la valeur NULL.
DRT_E_INVALID_TRANSPORT_PROVIDER	hTransport a la valeur NULL.
DRT_E_INVALID_SCOPE	L’étendue spécifiée n’est pas DRT_GLOBAL_SCOPE, DRT_SITE_LOCAL_SCOPE ou DRT_LINK_LOCAL_SCOPE.
DRT_E_TRANSPORT_UNEXPECTED	Une erreur inattendue s’est produite. Consultez TraceError pour la raison.

Note Cette fonction peut également retourner des erreurs des appels sous-jacents à NotifyUnicastIpAddressChange, WSAStartup, GetAdaptersAddresses, setsockopt, WSASocket, Bind, WSAIoctl, CreateThreadpoolIo, CreateThreadpoolCleanupGroup et CreateTimerQueue.

Notes

Le transport UDP IPv6 par défaut créé par cette fonction est spécifique à la DRT pour laquelle il est créé. Par conséquent, il ne peut pas être réutilisé sur plusieurs DRT.

Lorsque vous utilisez l’API Table de routage distribuée dans Windows XP avec Service Pack 2 (SP2), la prise en charge du protocole IPv6 doit être activée pour que la création d’un transport à l’aide de DrtCreateIpv6UdpTransport réussisse.

Spécifications


Client minimal pris en charge	Windows 7 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	drt.h
Bibliothèque	Drttransport.lib
DLL	Drt.dll

Voir aussi

DRT_SETTINGS

DrtDeleteIpv6UdpTransport

Partager via