DrtCreateIpv6UdpTransport-Funktion (drt.h)

Artikel
08/23/2023

Die DrtCreateIpv6UdpTransport-Funktion erstellt einen Transport basierend auf dem IPv6 UDP-Protokoll.

Syntax

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

Parameter

scope

Die DRT_SCOPE Enumeration, die den IPv6-Bereich angibt, in dem das DRT ausgeführt werden soll.

dwScopeId

Der Bezeichner, der die Schnittstelle, der dem Bereich zugeordnet ist, eindeutig angibt.

Für den globalen Bereich ist dieser Parameter immer die ID "GLOBAL_" und ist optional, wenn nur der globale Bereich verwendet wird. Für den lokalen Linkbereich stellt dieser Parameter die Schnittstelle dar, die der Netzwerkschnittstellenkarte zugeordnet ist, auf der der lokale Linkbereich vorhanden ist.

dwLocalityThreshold

Der Bezeichner, der angibt, wie Lokalitätsinformationen basierend auf IpV6-Adressen beim Zwischenspeichern von Nachbarn verwendet werden. Standardmäßig bevorzugt das DRT Nachbarn, die über eine IPv6-Adresse mit einem Präfix verfügen, das mit dem lokalen Computer gemeinsam ist.

[in, out] pwPort

Zeiger auf den Port, der vom lokalen DRT-instance verwendet wird.

[out] phTransport

Zeiger auf ein DRT-Transporthandle, das in der DRT_SETTINGS-Struktur angegeben ist.

Rückgabewert

Diese Funktion gibt S_OK nach Erfolg zurück. Weitere mögliche Werte sind:

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Das System kann dem Anbieter keinen Arbeitsspeicher zuweisen.
DRT_E_INVALID_PORT	pwPort ist NULL.
DRT_E_INVALID_TRANSPORT_PROVIDER	hTransport ist NULL.
DRT_E_INVALID_SCOPE	Der angegebene Bereich ist nicht DRT_GLOBAL_SCOPE, DRT_SITE_LOCAL_SCOPE oder DRT_LINK_LOCAL_SCOPE.
DRT_E_TRANSPORT_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten. Weitere Informationen finden Sie unter TraceError für den Grund.

Hinweis Diese Funktion kann auch Fehler von zugrunde liegenden Aufrufen von NotifyUnicastIpAddressChange, WSAStartup, GetAdaptersAddresses, setsockopt, WSASocket, Bind, WSAIoctl, CreateThreadpoolIo, CreateThreadpoolCleanupGroup und CreateTimerQueue zurückgeben.

Hinweise

Der von dieser Funktion erstellte Standard-IPv6-UDP-Transport ist spezifisch für das DRT, für das er erstellt wird. Daher kann es nicht über mehrere DRTs hinweg wiederverwendet werden.

Wenn Sie die API für verteilte Routingtabellen in Windows XP mit Service Pack 2 (SP2) verwenden, muss die Unterstützung des IPv6-Protokolls aktiviert sein, damit die Erstellung eines Transports mithilfe von DrtCreateIpv6UdpTransport erfolgreich ist.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	drt.h
Bibliothek	Drttransport.lib
DLL	Drt.dll

Weitere Informationen

DRT_SETTINGS

DrtDeleteIpv6UdpTransport

Freigeben über