Función RtlEthernetAddressToStringA (ip2string.h)

  • Artículo

La función RtlEthernetAddressToString convierte una dirección Ethernet binaria en una representación de cadena de la dirección MAC Ethernet.

Sintaxis

NTSYSAPI PSTR RtlEthernetAddressToStringA(
  [in]  const DL_EUI48 *Addr,
  [out] PSTR           S
);

Parámetros

[in] Addr

La dirección Ethernet en formato binario. La dirección Ethernet está en orden de red (bytes ordenados de izquierda a derecha).

[out] S

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

Valor devuelto

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

Comentarios

La función RtlEthernetAddressToString se usa para convertir una dirección Ethernet binaria en la representación de cadena de la dirección Ethernet en formato de dirección de capa de vínculo de datos EUI-48 Ethernet (también conocido como dirección MAC). La cadena representa una dirección Ethernet numérica expresada en la notación "-'' estándar no DIX.

La cadena devuelta en el parámetro S se representa en forma para una cadena de dirección MAC Ethernet en la notación "-" estándar no DIX. La representación de cadena básica de una dirección MAC Ethernet consta de 6 pares de números hexadecimales separados por guiones (F4-CE-46-2D-90-8C, por ejemplo).

RtlEthernetAddressToString 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 cadenas a direcciones Ethernet.

Cuando se define UNICODE o _UNICODE, RtlEthernetAddressToString se define en RtlEthernetAddressToStringW, 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, RtlEthernetAddressToString se define en RtlEthernetAddressToStringA, 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 .

El tipo de datos DL_EUI48 se define en el archivo de encabezado Mstcpip.h .

Nota

El encabezado ip2string.h define RtlEthernetAddressToString 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

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [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

Consulte también

RtlEthernetStringToAddress