Функция MprInfoBlockAdd (mprapi.h)
Функция MprInfoBlockAdd создает новый заголовок, идентичный существующему с добавлением нового блока.
Синтаксис
DWORD MprInfoBlockAdd(
[in] LPVOID lpHeader,
[in] DWORD dwInfoType,
[in] DWORD dwItemSize,
[in] DWORD dwItemCount,
[in] LPBYTE lpItemData,
[out] LPVOID *lplpNewHeader
);
Параметры
[in] lpHeader
Указатель на заголовок, в который добавляется новый блок.
[in] dwInfoType
Указывает тип добавляемого блока. Доступные типы зависят от транспорта: IPv4, IPv6 или IPX.
Windows Server 2008: Если dwInfoTYpe содержит IP_ROUTE_INFO, lpItemData должен указывать на структуру INTERFACE_ROUTE_INFO .
[in] dwItemSize
Задает размер каждого добавляемого элемента в блоке.
[in] dwItemCount
Указывает количество элементов размера dwItemSize , копируемых в качестве данных для нового блока.
[in] lpItemData
Указатель на данные для нового блока. Размер этого буфера в байтах должен быть равен произведению dwItemSize и dwItemCount.
[out] lplpNewHeader
Указатель на переменную указателя, которая при успешном возвращении указывает на новый заголовок.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.
Если функция завершается сбоем, возвращаемое значение будет одним из следующих значений.
| Значение | Описание |
|---|---|
|
Параметр lpHeader, lplpNewHeader или lpItemData имеет значение NULL или блок типа dwInfoType уже существует в заголовке. |
|
Вызов не выполнен. Используйте FormatMessage , чтобы получить сообщение об ошибке, соответствующее возвращаемому коду ошибки. |
Комментарии
После добавления блока сведений получите новый размер заголовка сведений, вызовив MprInfoBlockQuerySize.
Требования
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | mprapi.h |
| Библиотека | Mprapi.lib |
| DLL | Mprapi.dll |