Property Tables

A property table is an array of RESUTIL_PROPERTY_ITEM structures. Each entry in a property table contains information about a particular property and an offset to the property's data. The data, or a pointer to the data, is stored in a parameter block.

The following illustration shows the relationship between a property table and a parameter block. The property table has two entries, each represented by a RESUTIL_PROPERTY_ITEM structure. The Offset member of each property-table entry points to a member in the parameter block. Notice that non-property table data is included in the parameter block.

The type of data stored in the Default, Minimum, and Maximum members as well as in the corresponding parameter block depends on the value of the Format member. The following list indicates the relationship between the Format member and the type of data in the Default member and parameter block.

Format member	Default member	Parameter block
CLUSPROP_FORMAT_BINARY	Pointer to a buffer if the value is non-NULL.	LPBYTE pointing to the data followed by a DWORD to indicate the size of the data in bytes.
CLUSPROP_FORMAT_DWORD	DWORD	DWORD
CLUSPROP_FORMAT_EXPAND_SZ	Pointer to a NULL-terminated Unicode string if non-NULL.	LPWSTR
CLUSPROP_FORMAT_MULTI_SZ	Pointer to a buffer if the value is non-NULL.	LPWSTR pointing to the data followed by a DWORD to indicate the size of the data in bytes.
CLUSPROP_FORMAT_SZ	Pointer to a NULL-terminated Unicode string if non-NULL.	LPWSTR

 

For a discussion of creating and parsing property tables, see Using Lists and Tables.