PROPSPEC

The PROPSPEC structure is used by many of the methods of IPropertyStorage to specify a property either by its property identifier or the associated string name. The structure and related definitions are defined as follows in the header files:

const ULONG    PRSPEC_LPWSTR = 0
const ULONG    PRSPEC_PROPID = 1
 
typedef ULONG    PROPID
 
typedef struct tagPROPSPEC 
{
    ULONG ulKind;        // PRSPEC_LPWSTR or PRSPEC_PROPID
    union 
    {
    PROPID      propid;
    LPOLESTR    lpwstr;
    }
} PROPSPEC
 

Members

ulKind

If ulKind is set to PRSPEC_LPWSTR, lpwstr is used and set to a string name. If ulKind is set to PRSPEC_PROPID, propid is used and set to a property identifier value.

propid

Specifies the value of the property identifier. Use either this value or the following lpwstr, not both.

lpwstr

Specifies the string name of the property as a null-terminated Unicode string.

Remarks

String names are optional and can be assigned to a set of properties when the property is created with a call to IPropertyStorage::WriteMultiple, or later, with a call to IPropertyStorage::WritePropertyNames.

See Also

IPropertyStorage