This topic has not yet been rated - Rate this topic

SHCOLUMNID structure

Applies to: desktop apps only

Specifies the FMTID/PID identifier of a column that will be displayed by the Windows Explorer Details view.

Note As of Windows Vista, SHCOLUMNID is considered a legacy form and should not be used. In its place, use the PROPERTYKEY structure.

Syntax

Copy

typedef struct {
  GUID  fmtid;
  DWORD pid;
} SHCOLUMNID, *LPSHCOLUMNID;

Members

fmtid

Type: GUID

A property set format identifier or FMTID (a GUID). The Shell supports the storage, Shell details, and summary information property sets. Other property sets can be supported by particular folders.

({B725F130-47EF-101A-A5F1-02608C9EEBAC}): Storage property set. Defined in Ntquery.h.
({28636AA6-953D-11D2-B5D6-00C04FD918D0}): Shell details property set. Defined in Shlguid.h.
({9B174B33-40FF-11D2-A27E-00C04FC30871}): Displaced property set. Defined in Shlguid.h.
({9B174B34-40FF-11D2-A27E-00C04FC30871}): Miscellaneous property set. Defined in Shlguid.h.
({9B174B35-40FF-11D2-A27E-00C04FC30871}): Volume property set. Defined in Shlguid.h.
({49691C90-7E17-101A-A91C-08002B2ECDA9}): Query property set. Defined in Shlguid.h.
({F29F85E0-4FF9-1068-AB91-08002B27B3D9}): Summary information property set. Defined in Ntquery.h.

pid

Type: DWORD

The column's property identifier (PID).

The storage property set supports the five PIDs, defined in Ntquery.h.

PID	Value	Description	Type
PID_STG_NAME	10	The object's display name	VT_BSTR
PID_STG_STORAGETYPE	4	The object's type	VT_BSTR
PID_STG_SIZE	12	The object's size	VT_BSTR
PID_STG_WRITETIME	14	The object's modified attribute	VT_BSTR
PID_STG_ATTRIBUTES	13	The object's attributes	VT_BSTR

The Shell details property set supports three PIDs, defined in Shlguid.h. Note that PID_FINDDATA supports only the Unicode version of the WIN32_FIND_DATA structure.

Note These PIDs extract only information that is present in the object's PIDL. Since the content of a PIDL depends on the folder object that created the PIDL, there is no guarantee that all requested information will be available. In addition, the information that is returned reflects the state of the object at the time the PIDL was created. The current state of the object might be different. To retrieve complete current information on a file system file or folder, use standard file system functions such as GetFileTime or FindFirstFile.

PID	Value	Description	Type
PID_DESCRIPTIONID	2	A SHDESCRIPTIONID structure.	VT_ARRAY \| VT_UI1
PID_FINDDATA	0	A WIN32_FIND_DATAW structure.	VT_ARRAY \| VT_UI1
PID_NETRESOURCE	1	A NETRESOURCE structure.	VT_ARRAY \| VT_UI1

The displaced property set supports files that have been deleted and moved to the Recycle Bin. There are two PIDs, defined in Shlguid.h.

PID	Value	Description
PID_DISPLACED_FROM	2	Location that file was deleted from.
PID_DISPLACED_DATE	3	Date that the file was deleted.

The miscellaneous property set is used to support synchronization of briefcases or offline files. It has three PIDs, defined in Shlguid.h.

PID	Value	Description
PID_MISC_ACCESSCOUNT	3	Not used.
PID_MISC_OWNER	4	Ownership of the file (for the NTFS file system).
PID_MISC_STATUS	2	The synchronization status.

The query property set is used to support file searches. It has one PID, defined in Shlguid.h.

PID	Value	Description
PID_QUERY_RANK	2	The rank of the file.

The volume property set provides volume information. It has one PID, defined in Shlguid.h.

PID	Value	Description
PID_VOLUME_FREE	2	The amount of free space.

The summary information property set is a standard OLE property set that supports the following PIDs.

PID	Property name	Type
2	Title	VT_LPSTR
3	Subject	VT_LPSTR
4	Author	VT_LPSTR
5	Keywords	VT_LPSTR
6	Comments	VT_LPSTR
7	Template	VT_LPSTR
8	Last Saved By	VT_LPSTR
9	Revision Number	VT_LPSTR
10	Total Editing Time	VT_FILETIME
11	Last Printed	VT_FILETIME
12	Create Time/Date	VT_FILETIME
13	Last Saved Time/Date	VT_FILETIME
14	Number of Pages	VT_I4
15	Number of Words	VT_I4
16	Number of Characters	VT_I4
17	Thumbnail	VT_CF
18	Name of Creating Application	VT_LPSTR
19	Security	VT_I4

Remarks

As of Windows Vista, this structure was removed from the public headers and replaced by the PROPERTYKEY structure. SHCOLUMNID is now defined in Shtypes.h as follows.