ResUtilDupParameterBlock function (resapi.h)

Article
02/22/2024

Performs a member-wise copy of the data from one parameter block to another.

Syntax

DWORD ResUtilDupParameterBlock(
  [out] LPBYTE                       pOutParams,
  [in]  const LPBYTE                 pInParams,
  [in]  const PRESUTIL_PROPERTY_ITEM pPropertyTable
);

Parameters

[out] pOutParams

Pointer to the duplicated parameter block.

[in] pInParams

Pointer to the original parameter block.

[in] pPropertyTable

Pointer to an array of RESUTIL_PROPERTY_ITEM structures describing properties in the original parameter block.

Return value

If the operation succeeds, the function returns ERROR_SUCCESS.

If the operation fails, the function returns a system error code.

Remarks

ResUtilDupParameterBlock copies data only for parameter block members referenced in the pPropertyTable input parameter. If a variable in the input parameter block is a pointer, memory for the data is allocated with the function LocalAlloc. You should deallocate this memory by calling either LocalFree for each pointer variable in the output parameter block or ResUtilFreeParameterBlock. Make sure that you deallocate memory whether ResUtilDupParameterBlock succeeds or fails. For more information, see Using Parameter Blocks and Using Lists and Tables.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Target Platform	Windows
Header	resapi.h
Library	ResUtils.lib
DLL	ResUtils.dll