Skip to content

Latest commit

 

History

History
85 lines (65 loc) · 3.1 KB

nf-shlobj-icolumnprovider-getitemdata.md

File metadata and controls

85 lines (65 loc) · 3.1 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:shlobj.IColumnProvider.GetItemData
IColumnProvider::GetItemData (shlobj.h)
Requests column data for a specified file.
GetItemData
GetItemData method [Windows Shell]
GetItemData method [Windows Shell]
IColumnProvider interface
IColumnProvider interface [Windows Shell]
GetItemData method
IColumnProvider.GetItemData
IColumnProvider::GetItemData
_win32_IColumnProvider_GetItemData
shell.IColumnProvider_GetItemData
shlobj/IColumnProvider::GetItemData
shell\IColumnProvider_GetItemData.htm
shell
88e76f03-acc3-46b1-ad03-d2343f4f3dac
12/05/2018
GetItemData, GetItemData method [Windows Shell], GetItemData method [Windows Shell],IColumnProvider interface, IColumnProvider interface [Windows Shell],GetItemData method, IColumnProvider.GetItemData, IColumnProvider::GetItemData, _win32_IColumnProvider_GetItemData, shell.IColumnProvider_GetItemData, shlobj/IColumnProvider::GetItemData
shlobj.h
Windows
Windows 2000 Professional, Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Shell32.dll (version 5.0 or later)
Windows
19H1
IColumnProvider::GetItemData
shlobj/IColumnProvider::GetItemData
c++
APIRef
kbSyntax
COM
Shell32.dll
IColumnProvider.GetItemData

IColumnProvider::GetItemData

-description

Requests column data for a specified file.

-parameters

-param pscid [in]

Type: LPCSHCOLUMNID

An SHCOLUMNID structure that identifies the column.

-param pscd [in]

Type: LPCSHCOLUMNDATA

An SHCOLUMNDATA structure that specifies the file.

-param pvarData [out]

Type: VARIANT*

A pointer to a VARIANT with the data for the file specified by pscd that belongs in the column specified by pscid. Set this value if the file is a member of the class supported by the column provider.

-returns

Type: HRESULT

Returns S_OK if file data is returned, S_FALSE if the file is not supported by the column provider and no data is returned, or a COM error value otherwise.

-remarks

This method is called to retrieve the data for a file to be displayed in the specified column. It should be thread-safe.

This method is called for every file that Windows Explorer displays, even though many of them will not be supported by a particular column provider. To improve performance, first check the pwszExt member of the structure pointed to by pscd to see if it has a file name extension that is supported by the column provider. If not, avoid unnecessary processing by immediately returning S_FALSE.