ResUtilDupParameterBlock

The ResUtilDupParameterBlock utility function duplicates a parameter block.

DWORD WINAPI ResUtilDupParameterBlock(
  LPBYTE OutParams,                          
  const LPBYTE InParams,                      
  const PRESUTIL_PROPERTY_ITEM PropertyTable  
);
 

Parameters

OutParams
[out] Pointer to the duplicated parameter block.
InParams
[in] Pointer to the original parameter block.
PropertyTable
[in] Pointer to an array of RESUTIL_PROPERTY_ITEM structures describing properties in the original parameter block.

Return Values

ERROR_SUCCESS
The parameter block was duplicated successfully.

If the operation was unsuccessful, ResUtilDupParameterBlock returns a Win32® error value.

Notes to Callers

A parameter block is a buffer or structure that contains the data or pointers to data for the properties described in a property table. ResUtilDupParameterBlock copies the data found in the input parameter block pointed to by InParams to the output parameter block pointed to by OutParams. If a variable in the parameter block is a pointer, memory for the data is allocated using the Win32 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.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.