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

Статья
08/24/2023

Функция MprInfoBlockFind находит указанный блок в заголовке сведений и извлекает сведения о блоке.

Синтаксис

DWORD MprInfoBlockFind(
  [in]  LPVOID  lpHeader,
  [in]  DWORD   dwInfoType,
  [out] LPDWORD lpdwItemSize,
  [out] LPDWORD lpdwItemCount,
  [out] LPBYTE  *lplpItemData
);

Параметры

[in] lpHeader

Указывает заголовок, в котором следует найти блок.

[in] dwInfoType

Указывает тип блока для поиска. Доступные типы зависят от транспорта: IP или IPX.

[out] lpdwItemSize

Указатель на переменную DWORD , которая получает размер каждого элемента в данных расположенного блока. Этот параметр является необязательным. Если этот параметр имеет значение NULL, размер элемента не возвращается.

[out] lpdwItemCount

Указатель на переменную DWORD , которая получает количество элементов размера dwItemSize , содержащихся в данных блока. Этот параметр является необязательным. Если этот параметр имеет значение NULL, количество элементов не возвращается.

[out] lplpItemData

Указатель на указатель, который при успешном возвращении указывает на данные для расположенного блока. Этот параметр является необязательным. Если этот параметр имеет значение NULL, данные не возвращаются.

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

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

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

Значение	Описание
ERROR_INVALID_PARAMETER	Параметр lpInfoHeader имеет значение NULL.
ERROR_NOT_FOUND	В заголовке не существует блока типа dwInfoType .
Другое	Вызов не выполнен. Используйте FormatMessage , чтобы получить сообщение об ошибке, соответствующее возвращаемому коду ошибки.

Требования


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

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

FormatMessage

Функции и заголовки сведений MprInfo

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