PROPSPEC  6NUPXV0

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