ResUtilFreeParameterBlock function (resapi.h)

Article
10/13/2021

Deallocates memory that has been allocated for a parameter block by ResUtilDupParameterBlock.

Syntax

void ResUtilFreeParameterBlock(
  [in, out] LPBYTE                       pOutParams,
  [in]      const LPBYTE                 pInParams,
  [in]      const PRESUTIL_PROPERTY_ITEM pPropertyTable
);

Parameters

[in, out] pOutParams

Pointer to the parameter block to deallocate.

[in] pInParams

Pointer to the parameter block to use as a reference.

[in] pPropertyTable

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

Return value

None

Remarks

The ResUtilFreeParameterBlock utility function deallocates any memory allocated to each member of pOutParams, subject to the following limitations:

It will only deallocate memory for members referenced in the pPropertyTable input parameter.
It will not deallocate memory that is pointed to by any member of pInParams.

Do not use this function with parameter blocks that have not been allocated with ResUtilDupParameterBlock.

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