PROPERTYKEY structure

Specifies the FMTID/PID identifier that programmatically identifies a property. Replaces SHCOLUMNID.

Syntax

typedef struct _tagpropertykey {
  GUID  fmtid;
  DWORD pid;
} PROPERTYKEY;

Members

fmtid

Type: GUID

A unique GUID for the property.

pid

Type: DWORD

A property identifier (PID). This parameter is not used as in SHCOLUMNID. It is recommended that you set this value to PID_FIRST_USABLE. Any value greater than or equal to 2 is acceptable.

Note  Values of 0 and 1 are reserved and should not be used.
 

Remarks

As of Windows Vista, the SHCOLUMNID structure is simply an alias for PROPERTYKEY, as shown in this declaration from Shobjidl.h.

C++
typedef PROPERTYKEY SHCOLUMNID;

SHCOLUMNID can be considered a legacy structure with PROPERTYKEY being the new, preferred form. PROPERTYKEY has a broader purpose than SHCOLUMNID, and the new name is more descriptive of its uses.

Requirements

   
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Header wtypes.h