Export (0) Print
Expand All
Expand Minimize

SHCOLUMNID structure

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


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.

PIDValueDescriptionType
PID_STG_NAME10The object's display nameVT_BSTR
PID_STG_STORAGETYPE4The object's typeVT_BSTR
PID_STG_SIZE12The object's sizeVT_BSTR
PID_STG_WRITETIME14The object's modified attributeVT_BSTR
PID_STG_ATTRIBUTES13The object's attributesVT_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.

PIDValueDescriptionType
PID_DESCRIPTIONID2A SHDESCRIPTIONID structure.VT_ARRAY | VT_UI1
PID_FINDDATA0A WIN32_FIND_DATAW structure.VT_ARRAY | VT_UI1
PID_NETRESOURCE1A 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.

PIDValueDescription
PID_DISPLACED_FROM2Location that file was deleted from.
PID_DISPLACED_DATE3Date 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.

PIDValueDescription
PID_MISC_ACCESSCOUNT3Not used.
PID_MISC_OWNER4Ownership of the file (for the NTFS file system).
PID_MISC_STATUS2The synchronization status.

 

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

PIDValueDescription
PID_QUERY_RANK2The rank of the file.

 

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

PIDValueDescription
PID_VOLUME_FREE2The amount of free space.

 

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

PIDProperty nameType
2TitleVT_LPSTR
3SubjectVT_LPSTR
4AuthorVT_LPSTR
5KeywordsVT_LPSTR
6CommentsVT_LPSTR
7TemplateVT_LPSTR
8Last Saved ByVT_LPSTR
9Revision NumberVT_LPSTR
10Total Editing TimeVT_FILETIME
11Last PrintedVT_FILETIME
12Create Time/DateVT_FILETIME
13Last Saved Time/DateVT_FILETIME
14Number of PagesVT_I4
15Number of WordsVT_I4
16Number of CharactersVT_I4
17ThumbnailVT_CF
18Name of Creating ApplicationVT_LPSTR
19SecurityVT_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.


typedef PROPERTYKEY SHCOLUMNID;
typedef const SHCOLUMNID* LPCSHCOLUMNID;

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

See also

IShellFolder2::GetDetailsEx

 

 

Community Additions

ADD
Show:
© 2014 Microsoft