Función RtlEthernetStringToAddressA (ip2string.h)

La función RtlEthernetStringToAddress convierte una representación de cadena de una dirección MAC Ethernet en un formato binario de la dirección Ethernet.

Sintaxis

NTSYSAPI NTSTATUS RtlEthernetStringToAddressA(
  [in]  PCSTR    S,
  [out] PCSTR    *Terminator,
  [out] DL_EUI48 *Addr
);

Parámetros

[in] S

Puntero a un búfer que contiene la NULLrepresentación de cadena terminada de la dirección MAC Ethernet.

[out] Terminator

Parámetro que recibe un puntero al carácter que finalizó la cadena convertida. El autor de la llamada puede usar esto para extraer más información de la cadena.

[out] Addr

Puntero donde se va a almacenar la representación binaria de la dirección MAC Ethernet.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es STATUS_SUCCESS.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	Se pasó un parámetro no válido a la función . Este error se devuelve si la cadena a la que apunta el parámetro S no contenía una representación de cadena adecuada de una dirección MAC Ethernet. Este código de error se define en el archivo de encabezado Ntstatus.h.
otros	Use FormatMessage para obtener la cadena de mensaje para el error devuelto.

Observaciones

La función RtlEthernetStringToAddress se usa para convertir una representación de cadena de una dirección de capa de vínculo de datos EUI-48 Ethernet (también conocida como dirección MAC) al formato binario de la dirección Ethernet. La cadena representa una dirección Ethernet numérica expresada en la notación "-'' estándar no DIX. El valor devuelto es un número adecuado para su uso como dirección Ethernet. Todas las direcciones Ethernet se devuelven en orden de red (bytes ordenados de izquierda a derecha).

La cadena a la que apunta el parámetro S debe representarse 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).

Si se ejecuta correctamente, el terminador parámetro apunta al carácter que finalizó la cadena que se convirtió. Esto permite que una aplicación pase una cadena que contenga una dirección Ethernet más información adicional al función RtlEthernetStringToAddress y, a continuación, analice la información restante.

RtlEthernetStringToAddress 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 la cadena a la dirección Ethernet.

Cuando se define UNICODE o _UNICODE, rtlEthernetStringToAddress se define en RtlEthernetStringToAddressW, la versión Unicode de esta función. Los parámetros Y Terminator se definen en el tipo de datos PCWSTR.

Cuando no se definen UNICODE y _UNICODE, se define rtlEthernetStringToAddress para RtlEthernetStringToAddressA, la versión ANSI de esta función. Los parámetros Y Terminator de se definen en el tipo de datos pcSTR de .

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

Nota

El encabezado ip2string.h define RtlEthernetStringToAddress 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 7 [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2008 R2 [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

Consulte también

RtlEthernetAddressToString