MprInfoBlockAdd 函数 (mprapi.h)
MprInfoBlockAdd 函数通过添加新块创建与现有标头相同的新标头。
语法
DWORD MprInfoBlockAdd(
[in] LPVOID lpHeader,
[in] DWORD dwInfoType,
[in] DWORD dwItemSize,
[in] DWORD dwItemCount,
[in] LPBYTE lpItemData,
[out] LPVOID *lplpNewHeader
);
parameters
[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 |
| 标头 | mprapi.h |
| Library | Mprapi.lib |
| DLL | Mprapi.dll |