共用方式為


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

指定要加入的區塊類型。 可用的類型取決於傳輸: IPv4IPv6IPX

Windows Server 2008: 如果 dwInfoTYpe 包含 IP_ROUTE_INFOlpItemData 必須指向 INTERFACE_ROUTE_INFO 結構。

[in] dwItemSize

指定要加入之區塊中的每個專案大小。

[in] dwItemCount

指定要作為新區塊資料複製之 dwItemSize 大小的專案數目。

[in] lpItemData

新區塊資料的指標。 此緩衝區位元組的大小應等於 dwItemSizedwItemCount的乘積。

[out] lplpNewHeader

指標變數的指標,在成功傳回時會指向新的標頭。

傳回值

如果函式成功,傳回值會NO_ERROR。

如果函式失敗,則傳回值是下列其中一個值。

描述
ERROR_INVALID_PARAMETER
lpHeader、lplpNewHeaderlpItemData參數為Null,或標頭中已經存在dwInfoType類型的區塊。
其他
呼叫失敗。 使用 FormatMessage 擷取對應至傳回錯誤碼的錯誤訊息。

備註

新增資訊區塊之後,呼叫 MprInfoBlockQuerySize以取得資訊標頭的新大小。

需求

   
最低支援的用戶端 都不支援
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 mprapi.h
程式庫 Mprapi.lib
Dll Mprapi.dll

另請參閱

FormatMessage

MprInfo 函式和資訊標頭

MprInfoBlockQuerySize

MprInfoBlockRemove

MprInfoDuplicate