Função RtlIpv4AddressToStringA (ip2string.h)

Artigo
11/20/2024

A função RtlIpv4AddressToString converte um endereço IPv4 em uma cadeia de caracteres no formato pontilhado-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 bytes de rede.

[out] S

Um ponteiro para um buffer no qual armazenar a representação de cadeia de caracteres NULLterminada do endereço IPv4. Esse buffer deve ser grande o suficiente para conter pelo menos 16 caracteres.

Valor de retorno

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.

Observações

A função RtlIpv4AddressToString é usada para converter um endereço IPv4 na representação de cadeia de caracteres do endereço IPv4 no formato pontilhado-decimal da Internet.

RtlIpv4AddressToString é 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 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 de 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 SDK (Microsoft Windows Software Development Kit) lançado para Windows Vista. A função RtlIpv4AddressToString está incluída na biblioteca de importação Ntdll.lib incluída no WDK (Windows Driver Kit). 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	ip2string.h (include Mstcpip.h, Ip2string.h)
biblioteca	ntdll.lib
de DLL	ntdll.dll