ResUtilSetPropertyTable

The ResUtilSetPropertyTable utility function is used to set properties in the cluster database based on a property list from a property table.

DWORD WINAPI ResUtilSetPropertyTable(
  PVOID ClusterKey,                           
  const PRESUTIL_PROPERTY_ITEM PropertyTable,  
  PVOID Reserved,                        
  BOOL AllowUnknownProperties,                
  const PVOID InBuffer,
  DWORD InBufferSize,                          
  OPTIONAL LPBYTE OutParams                   
);
 

Parameters

ClusterKey

[in] Cluster database key identifying the location of the properties to set.

PropertyTable

[in] Pointer to an array of RESUTIL_PROPERTY_ITEM structures describing the properties to set.

Reserved

[in] Reserved.

AllowUnknownProperties

[in] Indicates whether or not unknown properties should be accepted. This parameter is set to TRUE if they should be accepted and FALSE otherwise.

InBuffer

[in] Pointer to the input buffer containing a property list.

InBufferSize

[in] Size in bytes of the input buffer pointed to by InBuffer.

OutParams

[out] Optional pointer to a parameter block to hold returned data. If specified, parameters will only be written if they differ from those in the input buffer.

Return Values

ERROR_SUCCESS

The properties were successfully set.

ERROR_BAD_ARGUMENTS

One or more of the input parameters were invalid.

ERROR_INSUFFICIENT_BUFFER

The size of the input buffer specified in InBufferSize is too small.

ERROR_INVALID_DATA

The input buffer pointed to by InBuffer is NULL, a property name is not valid, or a property value is too small.

ERROR_INVALID_PARAMETER

The syntax, format, or type of a property in the property table pointed to by PropertyTable is incorrect or a property is read-only and cannot be set.

QuickInfo

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