Поделиться через

Функция MprAdminInterfaceDeviceGetInfo (mprapi.h)

  • Статья

MprAdminInterfaceDeviceGetInfo извлекает сведения об устройстве, которое используется в интерфейсе по запросу маршрутизатора.

Синтаксис

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

Параметры

[in] hMprServer

Дескриптор маршрутизатора, на котором выполняется этот вызов. Получите этот дескриптор, вызвав MprAdminServerConnect.

[in] hInterface

Дескриптор интерфейса. Получите этот дескриптор из предыдущего вызова mprAdminInterfaceCreate или путем вызова MprAdminInterfaceEnum

[in] dwIndex

Указывает одноуровневый индекс устройства. Интерфейс набора номера по запросу с несколькими ссылками использует несколько устройств.

[in] dwLevel

Значение DWORD, описывающее формат, в котором возвращаются сведения в параметре lplpBuffer . Допустимые значения для dwLevel включают 0 или 1, как указано в следующей таблице.

Значение Формат структуры
0 MPR_DEVICE_0
1 MPR_DEVICE_1

[out] lplpBuffer

При успешном завершении указатель на MPR_DEVICE_0 или MPR_DEVICE_1 структуру. Параметр dwLevel указывает тип структуры. Освободите эту память, вызвав MprAdminBufferFree.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.

Значение Значение
ERROR_ACCESS_DENIED
 Вызывающее приложение не имеет достаточных привилегий.
ERROR_INVALID_HANDLE
 Недопустимое значение hInterface .
ERROR_INVALID_PARAMETER
 Параметр lplpbBuffer имеет значение NULL.
ERROR_NOT_ENOUGH_MEMORY
 Недостаточно ресурсов для завершения операции.
ERROR_NOT_SUPPORTED
 Недопустимое значение dwLevel .
 
 

Требования

   
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mprapi.h
Библиотека Mprapi.lib
DLL Mprapi.dll

См. также раздел

MPR_DEVICE_0

MPR_DEVICE_1

MprAdminInterfaceCreate

MprAdminInterfaceDeviceSetInfo