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 |
標頭 | mprapi.h |
程式庫 | Mprapi.lib |
Dll | Mprapi.dll |