Função MprAdminInterfaceDeviceGetInfo (mprapi.h)
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 |
|---|---|
|
O aplicativo de chamada não tem privilégios suficientes. |
|
O valor hInterface é inválido. |
|
O parâmetro lplpbBuffer é NULL. |
|
Recursos insuficientes para concluir a operação. |
|
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 |