Función RtlIpv4AddressToStringA (ip2string.h)

Artículo
11/20/2024

La función RtlIpv4AddressToString convierte una dirección IPv4 en una cadena en formato decimal con puntos estándar de Internet.

Sintaxis

NTSYSAPI PSTR RtlIpv4AddressToStringA(
  [in]  const in_addr *Addr,
  [out] PSTR          S
);

Parámetros

[in] Addr

Dirección IPv4 en orden de bytes de red.

[out] S

Puntero a un búfer en el que almacenar el nullrepresentación de cadena terminada en la dirección IPv4. Este búfer debe ser lo suficientemente grande como para contener al menos 16 caracteres.

Valor devuelto

Puntero al carácter NULL insertado al final de la representación de cadena de la dirección IPv4. El autor de la llamada puede usar esto para anexar fácilmente más información a la cadena.

Observaciones

La función rtlIpv4AddressToString se usa para convertir una dirección IPv4 en la representación de cadena de la dirección IPv4 en formato decimal con puntos de Internet.

RtlIpv4AddressToString es una función de conveniencia que no requiere que el archivo DLL de Windows Sockets se cargue para acceder a una función proporcionada en Windows Sockets para realizar la conversión de dirección IP a cadena.

Cuando se define UNICODE o _UNICODE, RtlIpv4AddressToString se define en RtlIpv4AddressToStringW, la versión Unicode de esta función. El parámetro string S y el valor devuelto de la función se definen en el tipo de datos PWSTR.

Cuando no se definen UNICODE y _UNICODE, se define RtlIpv4AddressToString para RtlIpv4AddressToStringA, la versión ANSI de esta función. El parámetro string S y el valor devuelto de la función se definen en el tipo de datos PSTR.

La estructura IN_ADDR se define en el archivo de encabezado Inaddr.h.

Una biblioteca de importación que contiene la función de RtlIpv4AddressToString no se incluye en el Kit de desarrollo de software (SDK) de Microsoft Windows publicado para Windows Vista. La función de RtlIpv4AddressToString se incluye en la biblioteca de importación ntdll.lib incluida en el Kit de controladores de Windows (WDK). Una aplicación también podría usar las funciones GetModuleHandle y GetProcAddress para recuperar el puntero de función de la Ntdll.dll y llamar a esta función.

Nota

El encabezado ip2string.h define RtlIpv4AddressToString como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2008 [aplicaciones de escritorio \| Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	ip2string.h (incluya Mstcpip.h, Ip2string.h)
biblioteca de	ntdll.lib
DLL de	ntdll.dll