Função RtlEthernetAddressToStringW (ip2string.h)

Artigo
11/20/2024

A função RtlEthernetAddressToString converte um endereço Ethernet binário em uma representação de cadeia de caracteres do endereço MAC Ethernet.

Sintaxe

NTSYSAPI PWSTR RtlEthernetAddressToStringW(
  [in]  const DL_EUI48 *Addr,
  [out] PWSTR          S
);

Parâmetros

[in] Addr

O endereço Ethernet no formato binário. O endereço Ethernet está em ordem de rede (bytes ordenados da esquerda para a direita).

[out] S

Um ponteiro para um buffer no qual armazenar a representação de cadeia de caracteresNULL terminada do endereço Ethernet. Esse buffer deve ser grande o suficiente para conter pelo menos 18 caracteres.

Valor de retorno

Um ponteiro para o caractere NULL inserido no final da representação de cadeia de caracteres do endereço MAC Ethernet. Isso pode ser usado pelo chamador para acrescentar facilmente mais informações à cadeia de caracteres.

Observações

A função rtlEthernetAddressToString é usada para converter um endereço Ethernet binário na representação de cadeia de caracteres do endereço Ethernet no formato de endereço de camada de vínculo de dados Ethernet EUI-48 (também conhecido como endereço MAC). A cadeia de caracteres representa um endereço Ethernet numérico expresso na notação "-'" padrão não DIX.

A cadeia de caracteres retornada no parâmetro S é representada no formulário para uma cadeia de caracteres de endereço MAC Ethernet na notação "-" padrão não DIX. A representação de cadeia de caracteres básica de um endereço MAC Ethernet consiste em 6 pares de números hexadecimal separados por traços (F4-CE-46-2D-90-8C, por exemplo).

RtlEthernetAddressToString é 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 a cadeia de caracteres para conversão de endereço Ethernet.

Quando unicode ou _UNICODE é definido, rtlEthernetAddressToString é definido como RtlEthernetAddressToStringW, 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, rtlEthernetAddressToString é definido como RtlEthernetAddressToStringA, 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 .

O tipo de dados DL_EUI48 é definido no arquivo de cabeçalho Mstcpip.h.

Nota

O cabeçalho ip2string.h define RtlEthernetAddressToString 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 7 [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows Server 2008 R2 [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

Consulte também

RtlEthernetStringToAddress

Compartilhar via