Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A função ConvertInterfaceNameToLuidA converte um nome de interface de rede ANSI para o identificador exclusivo local (LUID) para a interface.
Observação
A família de API ConvertInterfaceXxx enumera identificadores em todas as interfaces vinculadas ao TCP/IP, que podem incluir miniportas virtuais, filtros leves, adaptadores de túnel e interfaces físicas.
Sintaxe
NETIOAPI_API ConvertInterfaceNameToLuidA(
_In_ const CHAR *InterfaceName,
_Out_ NET_LUID *InterfaceLuid
);
Parâmetros
InterfaceName [em]
Um ponteiro para uma cadeia de caracteres ANSI terminada por NULL que contém o nome da interface de rede.InterfaceLuid [saída]
Um ponteiro para a união de NET_LUID para esta interface.
Valor de retorno
ConvertInterfaceNameToLuidA retorna STATUS_SUCCESS se a função for bem-sucedida. Se a função falhar, ConvertInterfaceNameToLuidA retornará um dos seguintes códigos de erro:
| Código de retorno | Descrição |
|---|---|
| ERROR_BUFFER_OVERFLOW | O comprimento do nome da interface ANSI é inválido. ConvertInterfaceNameToLuidA retornará esse erro se o parâmetro InterfaceName exceder o comprimento máximo permitido da cadeia de caracteres para esse parâmetro. |
| STATUS_INVALID_NAME | O nome da interface é inválido. ConvertInterfaceNameToLuidA retornará esse erro se o parâmetro InterfaceName contiver um nome de interface inválido. |
| STATUS_INVALID_PARAMETER | Um dos parâmetros é inválido. ConvertInterfaceNameToLuidA retornará esse erro se o parâmetro InterfaceLuid for NULL. |
Comentários
A função ConvertInterfaceNameToLuidA é 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 a dede terminação NULL , é definido no arquivo de cabeçalho Ntddndis.h. NDIS_IF_MAX_STRING_SIZE é definida como sendo a constante IF_MAX_STRING_SIZE, que é definida no arquivo de cabeçalho Ifdef.h.
Observação
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 o Ntddndis.h e Ifdef.h arquivos de cabeçalho diretamente.
Use a funçãoConvertInterfaceNameToLuidW para converter um nome de interface Unicode em um LUID.