ResUtilSetPrivatePropertyList

The ResUtilSetPrivatePropertyList utility function sets the private properties of a resource.

DWORD WINAPI ResUtilSetPrivatePropertyList(
  PVOID ClusterKey,  
  const PVOID InBuffer,  
  DWORD InBufferSize  
);
 

Parameters

ClusterKey

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

InBuffer

[in] Pointer to an input buffer containing a property list with the names and values of the properties to set.

InBufferSize

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

Return Values

ERROR_SUCCESS

The properties were updated successfully.

ERROR_BAD_ARGUMENTS

One or more of the input parameters were invalid.

ERROR_INVALID_DATA

There was a problem with the length of a property's data.

ERROR_INSUFFICIENT_BUFFER

The input buffer pointed to by InBuffer was NULL.

ERROR_INVALID_PARAMETER

The syntax of a property name was invalid.

Notes to Callers

The properties that are set in ResUtilSetPrivatePropertyList are placed in the portion of the cluster database below the specified key for the object exactly as specified by the names in the property list. If the name of a property contains backslash characters (\), each string preceding a backslash character will be interpreted as a subkey name, and the last string following the last backslash character will be interpreted as the value name.

QuickInfo

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