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 |
Library | Mprapi.lib |
[DLL] | Mprapi.dll |