Função MprAdminInterfaceTransportGetInfo (mprapi.h)

Artigo
08/24/2023

A função MprAdminInterfaceTransportGetInfo recupera informações sobre um transporte em execução em uma interface especificada.

Sintaxe

DWORD MprAdminInterfaceTransportGetInfo(
  [in]            MPR_SERVER_HANDLE hMprServer,
  [in]            HANDLE            hInterface,
  [in]            DWORD             dwTransportId,
  [out]           LPBYTE            *ppInterfaceInfo,
  [out, optional] LPDWORD           lpdwInterfaceInfoSize
);

Parâmetros

[in] hMprServer

Identificador para o roteador do qual as informações estão sendo recuperadas. Obtenha esse identificador chamando MprAdminServerConnect.

[in] hInterface

Manipule para a interface . Esse identificador é obtido de uma chamada anterior para MprAdminInterfaceCreate.

[in] dwTransportId

Um valor DWORD que descreve o transporte para o qual as informações são solicitadas. Os valores aceitáveis para dwTransportId estão listados na tabela a seguir.

Valor	Transporte (Família de Protocolos)
PID_ATALK	Appletalk
PID_IP	Protocolo internet versão 4
PID_IPX	Troca de Pacotes da Internet
PID_NBF	Protocolo NetBIOS Frames
PID_IPV6	Windows Server 2008 ou posterior: Protocolo de Internet versão 6

[out] ppInterfaceInfo

Ponteiro para uma variável de ponteiro. A variável de ponteiro aponta para um cabeçalho de informações que recebe informações para a interface e o transporte especificados. Use as Funções de Cabeçalho de Informações para manipular cabeçalhos de informações. Libere essa memória chamando MprAdminBufferFree.

[out, optional] lpdwInterfaceInfoSize

Ponteiro para uma variável DWORD . Essa variável recebe o tamanho em bytes das informações de interface retornadas por meio do parâmetro ppInterfaceInfo .

Esse parâmetro é opcional. Se o aplicativo de chamada especificar NULL para esse parâmetro, a função não retornará o tamanho das informações da interface.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos códigos de erro a seguir.

Valor	Significado
ERROR_ACCESS_DENIED	O aplicativo de chamada não tem privilégios suficientes.
ERROR_INVALID_HANDLE	O valor hInterface é inválido ou se a interface especificada estiver desabilitada administrativamente.
ERROR_NO_SUCH_INTERFACE	O transporte especificado não está em execução na interface especificada.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para concluir a operação.
ERROR_UNKNOWN_PROTOCOL_ID	O valor dwTransportId não corresponde a nenhum transporte com suporte.

Requisitos


Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mprapi.h
Biblioteca	Mprapi.lib
DLL	Mprapi.dll

Confira também

MprAdminInterfaceCreate

MprAdminInterfaceTransportSetInfo

MprAdminServerConnect

Funções de administração do roteador

Referência de gerenciamento de roteador

Compartilhar via