Función RtlIpv6AddressToStringA (ip2string.h)

Artículo
02/01/2024

La función RtlIpv6AddressToString convierte una dirección IPv6 en una cadena en formato estándar de Internet.

Sintaxis

NTSYSAPI PSTR RtlIpv6AddressToStringA(
  [in]  const in6_addr *Addr,
  [out] PSTR           S
);

Parámetros

[in] Addr

Dirección IPv6 en orden de bytes de red.

[out] S

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

Valor devuelto

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

Comentarios

La función RtlIpv6AddressToString se usa para convertir una dirección IPv6 en la representación de cadena de la dirección IPv6 en formato estándar de Internet.

La representación de cadena básica consta de 8 números hexadecimales separados por dos puntos. Una cadena de números cero consecutivos se reemplaza por dos puntos. Solo puede haber un signo de dos puntos en la representación de cadena de la dirección IPv6. Los últimos 32 bits se representan en notación de punto-octeto de estilo IPv4 si la dirección es una dirección compatible con IPv4, una dirección IPv4 asignada a IPv6 o una dirección ISATAP. Para obtener más información, consulte la sección 5 de RFC 5942 publicada por IETF.

RtlIpv6AddressToString es una función útil que no requiere que el archivo DLL de Windows Sockets se cargue para tener acceso 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, RtlIpv6AddressToString se define en RtlIpv6AddressToStringW, la versión Unicode de esta función. El parámetro de cadena S y el valor devuelto de la función se definen en el tipo de datos PWSTR.

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

La estructura IN6_ADDR se define en el archivo de encabezado In6addr.h .

No se incluye una biblioteca de importación que contiene la función RtlIpv6AddressToString en el Kit de desarrollo de software (SDK) de Microsoft Windows publicado para Windows Vista. La función RtlIpv6AddressToString 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 RtlIpv6AddressToString 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 Convenciones para prototipos de función.

Requisitos


Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	ip2string.h (incluya Mstcpip.h, Ip2string.h)
Library	ntdll.lib
Archivo DLL	ntdll.dll