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

ブロックのデータに含まれる dwItemSize サイズの項目数を受け取る DWORD 変数へのポインター。 このパラメーターは省略可能です。 このパラメーターが NULL の場合、項目数は返されません。

[out] lplpItemData

正常に戻った時点で、見つけたブロックのデータを指すポインターへのポインター。 このパラメーターは省略可能です。 このパラメーターが NULL の場合、データは返されません。

戻り値

関数が成功した場合、戻り値はNO_ERROR。

関数が失敗した場合、戻り値は次のいずれかの値になります。

値	説明
ERROR_INVALID_PARAMETER	lpInfoHeader パラメーターは NULL です。
ERROR_NOT_FOUND	dwInfoType 型のブロックがヘッダーに存在しません。
その他	呼び出しに失敗しました。 FormatMessage を使用して、返されたエラー コードに対応するエラー メッセージを取得します。

要件

サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	mprapi.h
Library	Mprapi.lib
[DLL]	Mprapi.dll

関連項目

FormatMessage

MprInfo 関数と情報ヘッダー