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

Статья
08/24/2023

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

Синтаксис

DWORD MprAdminInterfaceDeviceSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwIndex,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Параметры

[in] hMprServer

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

[in] hInterface

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

[in] dwIndex

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

[in] dwLevel

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

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

[in] lpbBuffer

Указатель на структуру MPR_DEVICE_0 или MPR_DEVICE_1 . Параметр dwLevel указывает тип структуры.

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

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

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

Значение	Значение
ERROR_ACCESS_DENIED	Вызывающее приложение не имеет достаточных привилегий.
ERROR_INVALID_HANDLE	Недопустимое значение hInterface .
ERROR_INVALID_PARAMETER	Параметр lplpBuffer имеет значение 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

MprAdminInterfaceDeviceGetInfo

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