MprInfoBlockSet

[This is preliminary documentation and subject to change.]

The MprInfoBlockSet creates a new header that is identical to an existing header with a specified block modified.

DWORD MprInfoBlockSet(
  LPVOID   lpInfoBlock,      // pointer to existing header 
  DWORD    dwInfoType,       // info type of block to modify
  DWORD    dwItemSize,       // new size of items in the modified block
  DWORD    dwItemCount,      // new number of items in the modified block 
  LPBYTE   lpItemData,       // new data for the modified block 
  LPVOID * lplpNewInfoBlock  // new header (incl. modified block) 
);

Parameters

lpInfoBlock: Pointer to header in which to modify the specified block.
dwInfoType: Specifies the type of block to change. The types available depend on the transport: IP or IPX.
dwItemSize: Specifies the size of each item in the block's new data.
dwItemCount: Specifies the number of items of size dwItemSize to be copied as the new data for the block.
lpItemData: Pointer to the new data for the block. This should point to a buffer with a size (in bytes) equal to the product of dwItemSize and dwItemCount.
lplpNewInfoBlock: Pointer to a pointer variable that, on successful return, points to the new header.

Return Values

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value will be one of the following values.

Value	Description
ERROR_INVALID_PARAMETER	One (or more) required parameters is NULL, or no block of type dwInfoType exists in the header.
Other	The call failed. Use FormatMessage to retrieve the error message corresponding to the returned error code.

MprInfoBlockSet

Parameters

Return Values

See Also