Método IColumnProvider::GetItemData (shlobj.h)

Solicita dados de coluna para um arquivo especificado.

Sintaxe

HRESULT GetItemData(
  [in]  LPCSHCOLUMNID   pscid,
  [in]  LPCSHCOLUMNDATA pscd,
  [out] VARIANT         *pvarData
);

Parâmetros

[in] pscid

Tipo: LPCSHCOLUMNID

Uma estrutura SHCOLUMNID que identifica a coluna.

[in] pscd

Tipo: LPCSHCOLUMNDATA

Uma estrutura SHCOLUMNDATA que especifica o arquivo.

[out] pvarData

Tipo: VARIANT*

Um ponteiro para um VARIANT com os dados do arquivo especificado por pscd que pertence à coluna especificada por pscid. Defina esse valor se o arquivo for um membro da classe compatível com o provedor de colunas.

Retornar valor

Tipo: HRESULT

Retorna S_OK se os dados do arquivo forem retornados, S_FALSE se o arquivo não tiver suporte do provedor de colunas e nenhum dado for retornado ou um valor de erro COM caso contrário.

Comentários

Esse método é chamado para recuperar os dados de um arquivo a ser exibido na coluna especificada. Ele deve ser thread-safe.

Esse método é chamado para cada arquivo que o Windows Explorer exibe, embora muitos deles não tenham suporte de um provedor de coluna específico. Para melhorar o desempenho, primeiro marcar o membro pwszExt da estrutura apontada pelo pscd para ver se ele tem uma extensão de nome de arquivo compatível com o provedor de colunas. Caso contrário, evite o processamento desnecessário retornando imediatamente S_FALSE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj.h
DLL	Shell32.dll (versão 5.0 ou posterior)