Función DrtCreateIpv6UdpTransport (drt.h)

  • Artículo

La función DrtCreateIpv6UdpTransport crea un transporte basado en el protocolo UDP IPv6.

Sintaxis

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

Parámetros

scope

La enumeración DRT_SCOPE que especifica el ámbito IPv6 en el que se va a operar el DRT.

dwScopeId

Identificador con el que se especifica de forma única la interfaz a la que está asociado el ámbito.

Para el ámbito global, este parámetro siempre es el identificador de "GLOBAL_" y es opcional cuando se usa solo el ámbito global. Para el ámbito local del vínculo, este parámetro representa la interfaz asociada a la tarjeta de interfaz de red en la que existe el ámbito local del vínculo.

dwLocalityThreshold

Identificador que especifica cómo se usa la información de localidad basada en direcciones IpV6 al almacenar en caché vecinos. De forma predeterminada, el DRT da preferencia a los vecinos que tienen una dirección IPv6 con un prefijo en común con el equipo local.

[in, out] pwPort

Puntero al puerto utilizado por la instancia de DRT local.

[out] phTransport

Puntero a un controlador de transporte DRT especificado en la estructura DRT_SETTINGS .

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles son:

Código devuelto Descripción
E_OUTOFMEMORY
 El sistema no puede asignar memoria para el proveedor.
DRT_E_INVALID_PORT
 pwPort es NULL.
DRT_E_INVALID_TRANSPORT_PROVIDER
 hTransport es NULL.
DRT_E_INVALID_SCOPE
 El ámbito especificado no se DRT_GLOBAL_SCOPE, DRT_SITE_LOCAL_SCOPE ni DRT_LINK_LOCAL_SCOPE.
DRT_E_TRANSPORT_UNEXPECTED
 Se produjo un error inesperado. Consulte TraceError por motivos.
 
Nota Esta función también puede devolver errores de las llamadas subyacentes a NotifyUnicastIpAddressChange,WSAStartup, GetAdaptersAddresses, setsockopt, WSASocket, Bind, WSAIoctl,CreateThreadpoolIo, CreateThreadpoolCleanupGroup y CreateTimerQueue.
 

Comentarios

El transporte UDP IPv6 predeterminado creado por esta función es específico del DRT para el que se crea. Como resultado, no se puede volver a usar en varios DRT.

Cuando se usa distributed Routing Table API en Windows XP con Service Pack 2 (SP2), la compatibilidad con el protocolo IPv6 debe estar habilitada para la creación de un transporte mediante DrtCreateIpv6UdpTransport para que se realice correctamente.

Requisitos

   
Cliente mínimo compatible Windows 7 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado drt.h
Library Drttransport.lib
Archivo DLL Drt.dll

Consulte también

DRT_SETTINGS

DrtDeleteIpv6UdpTransport