Gets detailed information on an item in a Shell folder.
HRESULT GetDetailsOf( [in, optional] PCUITEMID_CHILD pidl, UINT iColumn, [out] SHELLDETAILS *pDetails );
- pidl [in, optional]
The PIDL of the item that you are requesting information for. If this parameter is set to NULL, the title of the information field specified by iColumn will be returned in the SHELLDETAILS structure pointed to by pDetails.
The zero-based index of the desired information field. It is identical to column number of the information as it is displayed in a Windows Explorer Details view.
- pDetails [out]
A pointer to a SHELLDETAILS structure with the detail information.
Returns S_OK if successful. Returns E_FAIL if iColumn exceeds the number of columns supported by the folder. Otherwise, returns a standard COM error code.
The IShellDetails::GetDetailsOf method provides access to the information that is displayed in the Windows Explorer Details view of a Shell folder. The column numbers, column titles, and item information that you see in the Details view are identical to those returned by IShellDetails::GetDetailsOf.
The available information fields and their column numbers vary depending on the particular folder. To enumerate the available fields call IShellDetails::GetDetailsOf with pidl set to NULL for increasing values of iColumn. This approach provides you with the title associated with each column index. When iColumn exceeds the number of columns supported by the folder, IShellDetails::GetDetailsOf will return E_FAIL. Bear in mind that these titles are localizable, and may not be the same for all locales.
File system folders have a large standard set of information fields. The first four fields are standard for all file system folders.
|Column Index||Column Title|
File system folders may support a number of additional fields. However, they are not required to do so and the column indexes assigned to these fields may vary.
Each virtual folder has its own unique set of information fields. Typically, the item's display name is in column zero, but the order and content of the available fields depend on the implementation of the particular folder object.
Folder objects should implement IShellFolder2 instead of this interface.
Minimum supported client
|Windows XP [desktop apps only]|
Minimum supported server
|Windows Server 2003 [desktop apps only]|
Build date: 11/28/2012