Поделиться через

Функция DrtCreateIpv6UdpTransport (drt.h)

  • Статья

Функция DrtCreateIpv6UdpTransport создает транспорт на основе протокола UDP IPv6.

Синтаксис

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

Параметры

scope

Перечисление DRT_SCOPE, указывающее область IPv6, в котором будет работать DRT.

dwScopeId

Идентификатор, однозначно указывающий интерфейс, с которым связан область.

Для глобального область этот параметр всегда является идентификатором GLOBAL_ и необязательным при использовании только глобального область. Для локального область связи этот параметр представляет интерфейс, связанный с сетевой картой, на которой существует локальный область связи.

dwLocalityThreshold

Идентификатор, указывающий, как при кэшировании соседей используются сведения о расположении на основе ipV6-адресов. По умолчанию DRT отдается предпочтение соседям, имеющим IPv6-адрес с префиксом, общим для локального компьютера.

[in, out] pwPort

Указатель на порт, используемый локальным экземпляром DRT.

[out] phTransport

Указатель на дескриптор транспорта DRT, указанный в структуре DRT_SETTINGS .

Возвращаемое значение

Эта функция возвращает S_OK при успешном выполнении. Другие возможные значения:

Код возврата Описание
E_OUTOFMEMORY
 Система не может выделить память для поставщика.
DRT_E_INVALID_PORT
 pwPort имеет значение NULL.
DRT_E_INVALID_TRANSPORT_PROVIDER
 hTransport имеет значение NULL.
DRT_E_INVALID_SCOPE
 Указанный область не является DRT_GLOBAL_SCOPE, DRT_SITE_LOCAL_SCOPE или DRT_LINK_LOCAL_SCOPE.
DRT_E_TRANSPORT_UNEXPECTED
 Произошла непредвиденная ошибка. Причины см. в разделе TraceError.
 
Примечание Эта функция также может возвращать ошибки из базовых вызовов NotifyUnicastIpAddressChange,WSAStartup, GetAdaptersAddresses, setsockopt, WSASocket, Bind, WSAIoctl,CreateThreadpoolIo, CreateThreadpoolCleanupGroup и CreateTimerQueue.
 

Комментарии

Транспорт UDP по умолчанию IPv6, созданный этой функцией, относится к drt, для который он создается. В результате его нельзя повторно использовать в нескольких DRT.

При использовании API распределенной таблицы маршрутизации в Windows XP с пакетом обновления 2 (SP2) необходимо включить поддержку протокола IPv6 для успешного создания транспорта с помощью DrtCreateIpv6UdpTransport .

Требования

   
Минимальная версия клиента Windows 7 Профессиональная [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header drt.h
Библиотека Drttransport.lib
DLL Drt.dll

См. также раздел

DRT_SETTINGS

DrtDeleteIpv6UdpTransport