Função RtlIpv4AddressToStringA (ip2string.h)
A função RtlIpv4AddressToString converte um endereço IPv4 em uma cadeia de caracteres no formato dotted-decimal padrão da Internet.
Sintaxe
NTSYSAPI PSTR RtlIpv4AddressToStringA(
[in] const in_addr *Addr,
[out] PSTR S
);
Parâmetros
[in] Addr
O endereço IPv4 na ordem de byte 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 IPv4. Esse buffer deve ser grande o suficiente para conter pelo menos 16 caracteres.
Retornar valor
Um ponteiro para o caractere NULL inserido no final da representação de cadeia de caracteres do endereço IPv4. Isso pode ser usado pelo chamador para acrescentar facilmente mais informações à cadeia de caracteres.
Comentários
A função RtlIpv4AddressToString é usada para converter um endereço IPv4 na representação de cadeia de caracteres do endereço IPv4 no formato ponto-decimal da Internet.
RtlIpv4AddressToString é 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, RtlIpv4AddressToString é definido como RtlIpv4AddressToStringW, 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, RtlIpv4AddressToString é definido como RtlIpv4AddressToStringA, 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 IN_ADDR é definida no arquivo de cabeçalho Inaddr.h .
Uma biblioteca de importação que contém a função RtlIpv4AddressToString não está incluída no Microsoft Windows Software Development Kit (SDK) lançado para Windows Vista. A função RtlIpv4AddressToString 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 RtlIpv4AddressToString 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 |