ResUtilFreeParameterBlock function (resapi.h)

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

See also

RESUTIL_PROPERTY_ITEM

ResUtilDupParameterBlock