Compartilhar via

Função DrtCreateIpv6UdpTransport (drt.h)

  • Artigo

A função DrtCreateIpv6UdpTransport cria um transporte com base no protocolo UDP IPv6.

Sintaxe

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

Parâmetros

scope

O DRT_SCOPE enumeração que especifica o escopo IPv6 no qual o DRT deve operar.

dwScopeId

O identificador que especifica exclusivamente a interface à qual o escopo está associado.

Para o escopo global, esse parâmetro é sempre a ID "GLOBAL_" e é opcional ao usar apenas o escopo global. Para o escopo local do link, esse parâmetro representa a interface associada ao Cartão de Interface de Rede no qual o escopo local do link existe.

dwLocalityThreshold

O identificador que especifica como as informações de Localidade com base em endereços IpV6 são usadas ao armazenar em cache vizinhos. Por padrão, o DRT dá preferência aos vizinhos que têm um endereço IPv6 com um prefixo em comum com o computador local.

[in, out] pwPort

Ponteiro para a porta utilizada pela instância drt local.

[out] phTransport

Ponteiro para um identificador de transporte DRT especificado na estrutura DRT_SETTINGS .

Valor retornado

Essa função retorna S_OK com êxito. Outros valores possíveis incluem:

Código de retorno Descrição
E_OUTOFMEMORY
 O sistema não pode alocar memória para o provedor.
DRT_E_INVALID_PORT
 pwPort é NULL.
DRT_E_INVALID_TRANSPORT_PROVIDER
 hTransport é NULL.
DRT_E_INVALID_SCOPE
 O escopo especificado não é DRT_GLOBAL_SCOPE, DRT_SITE_LOCAL_SCOPE ou DRT_LINK_LOCAL_SCOPE.
DRT_E_TRANSPORT_UNEXPECTED
 Ocorreu um erro inesperado. Consulte TraceError por motivo.
 
Nota Essa função também pode retornar erros de chamadas subjacentes para NotifyUnicastIpAddressChange, WSAStartup, GetAdaptersAddresses, setsockopt, WSASocket, Bind, WSAIoctl, CreateThreadpoolIo, CreateThreadpoolCleanupGroup e CreateTimerQueue.
 

Comentários

O transporte UDP IPv6 padrão criado por essa função é específico para o DRT para o qual ele é criado. Como resultado, ele não pode ser usado novamente em vários DRTs.

Ao usar a API de Tabela de Roteamento Distribuído no Windows XP com Service Pack 2 (SP2), o suporte ao protocolo IPv6 deve ser habilitado para a criação de um transporte usando DrtCreateIpv6UdpTransport para ser bem-sucedido.

Requisitos

   
Cliente mínimo com suporte Windows 7 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho drt.h
Biblioteca Drttransport.lib
DLL Drt.dll

Confira também

DRT_SETTINGS

DrtDeleteIpv6UdpTransport