Função MprAdminInterfaceTransportGetInfo (mprapi.h)
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 |
|---|---|
|
O aplicativo de chamada não tem privilégios suficientes. |
|
O valor hInterface é inválido ou se a interface especificada estiver desabilitada administrativamente. |
|
O transporte especificado não está em execução na interface especificada. |
|
Recursos insuficientes para concluir a operação. |
|
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
MprAdminInterfaceTransportSetInfo