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

Функция MprAdminDeviceEnum вызывается для перечисления устройств с поддержкой RAS, установленных на компьютере, которые могут возвращать их имя и тип.

Синтаксис

DWORD MprAdminDeviceEnum(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer,
  [out] LPDWORD           lpdwTotalEntries
);

Параметры

[in] hMprServer

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

[in] dwLevel

Значение DWORD, описывающее формат, в котором возвращаются сведения в параметре lplpbBuffer . Должен равняться нулю.

[out] lplpbBuffer

После успешного завершения массив структур MPR_DEVICE_0 , содержащий сведения об устройстве, поддерживающем RAS. Освободите эту память, вызвав MprAdminBufferFree.

[out] lpdwTotalEntries

Количество записей типа MPR_DEVICE_0 в lplpbBuffer.

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

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

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

Значение	Значение
ERROR_NOT_SUPPORTED	Параметр dwlevel не равен нулю.
ERROR_INVALID_PARAMETER	Параметр lplpbBuffer или lpdwTotalEntries имеет значение NULL.

Требования

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

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

MprAdminServerConnect

Функции администрирования маршрутизатора

Справочник по управлению маршрутизаторами