Função RtlIpv6StringToAddressExW (ip2string.h)

A função RtlIpv6StringToAddressEx converte uma representação de cadeia de caracteres de um endereço IPv6, ID de escopo e número de porta em um endereço IPv6 binário, ID de escopo e porta.

Sintaxe

NTSYSAPI NTSTATUS RtlIpv6StringToAddressExW(
  [in]  PCWSTR   AddressString,
  [out] in6_addr *Address,
  [out] PULONG   ScopeId,
  [out] PUSHORT  Port
);

Parâmetros

[in] AddressString

Um ponteiro para um buffer que contém a representação de cadeia de caracteres terminada em NULL do endereço IPv6, da ID do escopo e do número da porta.

[out] Address

Um ponteiro em que a representação binária do endereço IPv6 deve ser armazenada.

[out] ScopeId

Um ponteiro para onde a ID de escopo do endereço IPv6 é armazenada. Se o parâmetro AddressString não contiver a representação de cadeia de caracteres de uma ID de escopo, zero será retornado nesse parâmetro.

[out] Port

Um ponteiro em que o número da porta é armazenado. O número da porta está no formato de ordem de bytes de rede. Se o parâmetro AddressString não contiver a representação de cadeia de caracteres de um número de porta, zero será retornado nesse parâmetro.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Observações

A função RtlIpv6StringToAddressEx é usada para converter uma representação de cadeia de caracteres do endereço IPv6, ID de escopo e número da porta em um endereço IPv6 binário, ID de escopo e número de porta. O endereço IPv6 é retornado em ordem de rede (bytes ordenados da esquerda para a direita). O número da porta e a ID do escopo são retornados na ordem de rede.

RtlIpv6StringToAddressEx é uma função de conveniência que não exige que a DLL dos Soquetes do Windows seja carregada para acessar uma função fornecida nos Soquetes do Windows para executar a cadeia de caracteres para conversão de endereço IP.

A cadeia de caracteres apontada pelo parâmetro AddressString deve ser representada no formulário para uma cadeia de caracteres de endereço IPv6 seguida por um caractere de porcentagem opcional e uma cadeia de caracteres de ID de escopo. O endereço IPv6 e a cadeia de caracteres de ID de escopo devem estar entre colchetes. O colchete direito após o endereço IPv6 e a cadeia de caracteres de ID de escopo podem ser seguidos por dois-pontos opcionais e uma representação de cadeia de caracteres de um número de porta. A representação de cadeia de caracteres básica de um endereço IPv6 consiste em 8 números hexadecimal separados por dois-pontos. Uma cadeia de caracteres de números zero consecutivos pode ser substituída por dois-pontos. Só pode haver dois-pontos na representação da cadeia de caracteres do endereço IPv6. Os últimos 32 bits poderão ser representados na notação dotted-octet no estilo IPv4 se o endereço for um endereço compatível com IPv4, um endereço IPv6 mapeado por IPv4 ou um endereço ISATAP. Para obter mais informações, consulte a seção 5 do RFC 5942 publicada pelo IETF.

Quando UNICODE ou _UNICODE é definido, RtlIpv6StringToAddressEx é definido como RtlIpv6StringToAddressExW, a versão Unicode dessa função. O parâmetro AddressString é definido como o tipo de dados PCWSTR.

Quando unicode e _UNICODE não são definidos, RtlIpv6StringToAddressEx é definido como RtlIpv6StringToAddressExA, a versão ANSI dessa função. O parâmetro AddressString é definido como o tipo de dados PCSTR.

A estrutura IN6_ADDR é definida no arquivo de cabeçalho In6addr.h.

Requirements

Consulte também

GetModuleHandle

GetProcAddress

IN6_ADDR

InetNtop

InetPton

LoadLibrary

RtlIpv4AddressToString

RtlIpv4AddressToStringEx

RtlIpv4StringToAddress

RtlIpv4StringToAddressEx

RtlIpv6AddressToString

RtlIpv6AddressToStringEx

RtlIpv6StringToAddress

inet_addr

inet_ntoa