Função MprAdminInterfaceDeviceGetInfo (mprapi.h)

Artigo
08/24/2023

O MprAdminInterfaceDeviceGetInfo recupera informações sobre um dispositivo usado em uma interface demand-dial do roteador.

Sintaxe

DWORD MprAdminInterfaceDeviceGetInfo(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwIndex,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpBuffer
);

Parâmetros

[in] hMprServer

Identificador para o roteador no qual executar essa chamada. Obtenha esse identificador chamando MprAdminServerConnect.

[in] hInterface

Manipule para a interface . Obtenha esse identificador de uma chamada anterior para MprAdminInterfaceCreate ou chamando MprAdminInterfaceEnum

[in] dwIndex

Especifica o índice baseado em um do dispositivo. Uma interface de discagem de demanda multi-vinculada usa vários dispositivos.

[in] dwLevel

Um valor DWORD que descreve o formato no qual as informações são retornadas no parâmetro lplpBuffer . Os valores aceitáveis para dwLevel incluem 0 ou 1, conforme listado na tabela a seguir.

Valor	Formato de estrutura
0	MPR_DEVICE_0
1	MPR_DEVICE_1

[out] lplpBuffer

Após a conclusão bem-sucedida, um ponteiro para uma estrutura MPR_DEVICE_0 ou MPR_DEVICE_1 . O parâmetro dwLevel indica o tipo de estrutura. Libere essa memória chamando MprAdminBufferFree.

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.
ERROR_INVALID_PARAMETER	O parâmetro lplpbBuffer é NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para concluir a operação.
ERROR_NOT_SUPPORTED	O valor dwLevel é inválido.

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

MPR_DEVICE_0

MPR_DEVICE_1

MprAdminInterfaceCreate

MprAdminInterfaceDeviceSetInfo

Compartilhar via