ResUtilPropertyListFromParameterBlock

The ResUtilPropertyListFromParameterBlock utility function constructs a property list from a parameter block.

DWORD WINAPI ResUtilPropertyListFromParameterBlock(
  const PRESUTIL_PROPERTY_ITEM PropertyTable,  
  PVOID OutBuffer,                            
  DWORD OutBufferSize,                         
  const LPBYTE InParams,
  LPDWORD BytesReturned,                      
  LPDWORD Required                            
);
 

Parameters

PropertyTable

[in] Pointer to an array of RESUTIL_PROPERTY_ITEM structures that describes the parameter block to process.

OutBuffer

[out] Pointer to an output buffer in which a property list with the names and values of the properties in the parameter block should be returned.

OutBufferSize

[in] Size of the output buffer.

InParams

[in] Parameter block containing the properties out of which the property list returned in OutBuffer is constructed.

BytesReturned

[out] Pointer to the total number of bytes in the property list pointed to by OutBuffer.

Required

[out] Pointer to the number of bytes that is required if OutBuffer is too small to hold the properties from the parameter block.

Return Values

ERROR_SUCCESS

The properties were returned successfully.

ERROR_BAD_ARGUMENTS

One or more of the input parameters were invalid.

ERROR_NOT_ENOUGH_MEMORY

There was an error allocating memory.

If the operation was unsuccessful, ResUtilPropertyListFromParameterBlock can also return a Win32® error value.

QuickInfo

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