次の方法で共有

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。

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

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

解説

情報ブロックを追加した後、 MprInfoBlockQuerySize を呼び出して情報ヘッダーの新しいサイズを取得します。

要件

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

関連項目

FormatMessage

MprInfo 関数と情報ヘッダー

MprInfoBlockQuerySize

MprInfoBlockRemove

MprInfoDuplicate