Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A função ConvertInterfaceNameToLuidW converte um nome de interface de rede Unicode no LUID (identificador local exclusivo) para a interface.
Nota
A família de APIXxx enumera identificadores em todas as interfaces associadas ao TCP/IP, que podem incluir miniportos virtuais, filtros leves, adaptadores de túnel e interfaces físicas.
Sintaxe
NETIOAPI_API ConvertInterfaceNameToLuidW(
_In_ const WCHAR *InterfaceName,
_Out_ NET_LUID *InterfaceLuid
);
Parâmetros
InterfaceName [in]
Um ponteiro para uma cadeia de caracteres Unicode terminada em NULL que contém o nome do adaptador de rede.InterfaceLuid [out]
Um ponteiro para a união NET_LUID para essa interface.
Valor de retorno
ConvertInterfaceNameToLuidW retornará STATUS_SUCCESS se a função for bem-sucedida. Se a função falhar, ConvertInterfaceNameToLuidW retornará um dos seguintes códigos de erro:
| Código de retorno | Descrição |
|---|---|
| STATUS_INVALID_NAME | O nome da interface é inválido. ConvertInterfaceNameToLuidW retornará esse erro se o parâmetro InterfaceName contiver um nome inválido ou o comprimento do parâmetro InterfaceName exceder o comprimento máximo de cadeia de caracteres permitido para esse parâmetro. |
| STATUS_INVALID_PARAMETER | Um dos parâmetros é inválido. ConvertInterfaceNameToLuidW retornará esse erro se o parâmetro InterfaceLuid estiver NULL. |
Observações
A função ConvertInterfaceNameToLuidW é independente de protocolo e funciona com interfaces de rede para os protocolos IPv6 e IPv4.
O comprimento máximo do nome da interface de rede, NDIS_IF_MAX_STRING_SIZE, sem o caractere NULL de terminação, é definido no arquivo de cabeçalho Ntddndis.h. NDIS_IF_MAX_STRING_SIZE é definido como a constante IF_MAX_STRING_SIZE, que é definida no arquivo de cabeçalho Ifdef.h.
Nota
Os arquivos de cabeçalho Ntddndis.h e Ifdef.h são incluídos automaticamente no arquivo de cabeçalho Netioapi.h. Você nunca deve usar os arquivos de cabeçalho Ntddndis.h e Ifdef.h diretamente.
Use a funçãoConvertInterfaceNameToLuidA para converter um nome de interface ANSI em um LUID.
Requisitos
Plataforma de destino |
Universal |
Versão |
Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
Cabeçalho |
Netioapi.h (inclua Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |