Função RtlIpv6AddressToStringW (ip2string.h)

Artigo
08/24/2023

A função RtlIpv6AddressToString converte um endereço IPv6 em uma cadeia de caracteres no formato padrão da Internet.

Sintaxe

NTSYSAPI PWSTR RtlIpv6AddressToStringW(
  [in]  const in6_addr *Addr,
  [out] PWSTR          S
);

Parâmetros

[in] Addr

O endereço IPv6 na ordem de bytes de rede.

[out] S

Um ponteiro para um buffer no qual armazenar a representação de cadeia de caracteres terminada em NULL do endereço IPv6. Esse buffer deve ser grande o suficiente para conter pelo menos 46 caracteres.

Retornar valor

Um ponteiro para o caractere NULL inserido no final da representação de cadeia de caracteres do endereço IPv6. Isso pode ser usado pelo chamador para acrescentar facilmente mais informações à cadeia de caracteres.

Comentários

A função RtlIpv6AddressToString é usada para converter um endereço IPv6 na representação de cadeia de caracteres do endereço IPv6 no formato padrão da Internet.

A representação de cadeia de caracteres básica consiste em 8 números hexadecimal separados por dois-pontos. Uma cadeia de caracteres de números zero consecutivos é substituída por dois-pontos. Só pode haver dois-pontos na representação de cadeia de caracteres do endereço IPv6. Os últimos 32 bits serão representados na notação dotted-octet no estilo IPv4 se o endereço for 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 publicado pelo IETF.

RtlIpv6AddressToString é uma função de conveniência que não exige que a DLL do Windows Sockets seja carregada para acessar uma função fornecida no Windows Sockets para executar o endereço IP em conversão de cadeia de caracteres.

Quando UNICODE ou _UNICODE é definido, RtlIpv6AddressToString é definido como RtlIpv6AddressToStringW, a versão Unicode dessa função. O parâmetro de cadeia de caracteres S e o valor retornado da função são definidos para o tipo de dados PWSTR.

Quando unicode e _UNICODE não são definidos, RtlIpv6AddressToString é definido como RtlIpv6AddressToStringA, a versão ANSI dessa função. O parâmetro de cadeia de caracteres S e o valor retornado da função são definidos para o tipo de dados PSTR.

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

Uma biblioteca de importação que contém a função RtlIpv6AddressToString não está incluída no Microsoft Windows Software Development Kit (SDK) lançado para Windows Vista. A função RtlIpv6AddressToString está incluída na biblioteca de importação Ntdll.lib incluída no WDK (Kit de Driver do Windows). Um aplicativo também pode usar as funções GetModuleHandle e GetProcAddress para recuperar o ponteiro de função do Ntdll.dll e chamar essa função.

Observação

O cabeçalho ip2string.h define RtlIpv6AddressToString como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos


Cliente mínimo com suporte	Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	ip2string.h (inclua Mstcpip.h, Ip2string.h)
Biblioteca	ntdll.lib
DLL	ntdll.dll