PROPERTYKEY structure (wtypes.h)

  • Article

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.

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

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