Função RtlEthernetStringToAddressW (ip2string.h)
A função RtlEthernetStringToAddress converte uma representação de cadeia de caracteres de um endereço MAC Ethernet em um formato binário do endereço Ethernet.
Sintaxe
NTSYSAPI NTSTATUS RtlEthernetStringToAddressW(
[in] PCWSTR S,
[out] LPCWSTR *Terminator,
[out] DL_EUI48 *Addr
);
Parâmetros
[in] S
Um ponteiro para um buffer que contém a representação de cadeia de caracteres terminada em NULL do endereço MAC Ethernet.
[out] Terminator
Um parâmetro que recebe um ponteiro para o caractere que encerrou a cadeia de caracteres convertida. Isso pode ser usado pelo chamador para extrair mais informações da cadeia de caracteres.
[out] Addr
Um ponteiro em que a representação binária do endereço MAC Ethernet deve ser armazenada.
Retornar valor
Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.
Se a função falhar, o valor retornado será um dos códigos de erro a seguir.
Código de retorno | Descrição |
---|---|
|
Um parâmetro inválido foi passado para a função. Esse erro será retornado se a cadeia de caracteres apontada pelo parâmetro S não contiver uma representação de cadeia de caracteres adequada de um endereço MAC Ethernet.
Esse código de erro é definido no arquivo de cabeçalho Ntstatus.h . |
|
Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado. |
Comentários
A função RtlEthernetStringToAddress é usada para converter uma representação de cadeia de caracteres de um endereço de camada de vínculo de dados Ethernet EUI-48 (também conhecido como endereço MAC) em formato binário do endereço Ethernet. A cadeia de caracteres representa um endereço Ethernet numérico expresso na notação "-'" padrão não DIX. O valor retornado é um número adequado para uso como um endereço Ethernet. Todos os endereços Ethernet são retornados em ordem de rede (bytes ordenados da esquerda para a direita).
A cadeia de caracteres apontada pelo parâmetro S deve ser 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 seis pares de números hexadecimais separados por traços (F4-CE-46-2D-90-8C, por exemplo).
Em caso de êxito, o parâmetro Terminator aponta para o caractere que encerrou a cadeia de caracteres que foi convertida. Isso permite que um aplicativo passe uma cadeia de caracteres que contém um endereço Ethernet mais informações adicionais para a função RtlEthernetStringToAddress e, em seguida, analise as informações restantes.
RtlEthernetStringToAddress é uma função de conveniência que não exige que a DLL do Windows Sockets seja carregada para acessar uma função fornecida no Windows Sockets para executar a conversão de cadeia de caracteres para o endereço Ethernet.
Quando UNICODE ou _UNICODE é definido, RtlEthernetStringToAddress é definido como RtlEthernetStringToAddressW, a versão Unicode dessa função. Os parâmetros S e Terminator são definidos para o tipo de dados PCWSTR .
Quando UNICODE e _UNICODE não são definidos, RtlEthernetStringToAddress é definido como RtlEthernetStringToAddressA, a versão ANSI dessa função. Os parâmetros S e Terminator são definidos para o tipo de dados PCSTR .
O tipo de dados DL_EUI48 é definido no arquivo de cabeçalho Mstcpip.h .
Observação
O cabeçalho ip2string.h define RtlEthernetStringToAddress como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
Cliente mínimo com suporte | Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
Servidor mínimo com suporte | Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
Plataforma de Destino | Windows |
Cabeçalho | ip2string.h (inclua Mstcpip.h, Ip2string.h) |
Biblioteca | ntdll.lib |
DLL | ntdll.dll |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de