MprInfoBlockFind 函式 (mprapi.h)

MprInfoBlockFind函式會在資訊標頭中找出指定的區塊，並擷取區塊的相關資訊。

語法

DWORD MprInfoBlockFind(
  [in]  LPVOID  lpHeader,
  [in]  DWORD   dwInfoType,
  [out] LPDWORD lpdwItemSize,
  [out] LPDWORD lpdwItemCount,
  [out] LPBYTE  *lplpItemData
);

參數

[in] lpHeader

指定要在其中尋找區塊的標頭。

[in] dwInfoType

指定要尋找的區塊類型。 可用的類型取決於傳輸： IP 或 IPX。

[out] lpdwItemSize

DWORD變數的指標，該變數會接收所找到區塊資料中每個專案的大小。 這是選擇性參數。 如果此參數為 Null，則不會傳回專案大小。

[out] lpdwItemCount

DWORD變數的指標，該變數會接收區塊資料中包含的dwItemSize大小專案數。 這是選擇性參數。 如果此參數為 Null，則不會傳回專案計數。

[out] lplpItemData

指標，在成功傳回時指向所找到區塊的資料。 這是選擇性參數。 如果此參數為 Null，則不會傳回資料。

傳回值

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

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

值	描述
ERROR_INVALID_PARAMETER	lpInfoHeader參數為Null。
ERROR_NOT_FOUND	標頭中沒有 類型 dwInfoType 的區塊。
其他	呼叫失敗。 使用 FormatMessage 擷取對應至傳回錯誤碼的錯誤訊息。

需求

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

另請參閱

FormatMessage

MprInfo 函式和資訊標頭