MprInfoBlockAdd 函数 (mprapi.h)

项目
08/24/2023

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。

如果函数失败，则返回值为以下值之一。

值	说明
ERROR_INVALID_PARAMETER	lpHeader、lplpNewHeader 或 lpItemData 参数为 NULL，或者标头中已存在 dwInfoType 类型的块。
其他	调用失败。使用 FormatMessage 检索与返回的错误代码对应的错误消息。

注解

添加信息块后，通过调用 MprInfoBlockQuerySize 获取信息标头的新大小。

要求


最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	mprapi.h
Library	Mprapi.lib
DLL	Mprapi.dll