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

Solicita datos de columna para un archivo especificado.

Sintaxis

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

Parámetros

[in] pscid

Tipo: LPCSHCOLUMNID

Estructura SHCOLUMNID que identifica la columna.

[in] pscd

Tipo: LPCSHCOLUMNDATA

Estructura SHCOLUMNDATA que especifica el archivo.

[out] pvarData

Tipo: VARIANT*

Puntero a un variant con los datos del archivo especificado por pscd que pertenece a la columna especificada por pscid. Establezca este valor si el archivo es miembro de la clase compatible con el proveedor de columnas.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se devuelven datos de archivo, S_FALSE si el archivo no es compatible con el proveedor de columnas y no se devuelve ningún dato o un valor de error COM en caso contrario.

Comentarios

Se llama a este método para recuperar los datos de un archivo que se mostrarán en la columna especificada. Debe ser seguro para subprocesos.

Se llama a este método para cada archivo que muestra el Explorador de Windows, aunque muchos de ellos no serán compatibles con un proveedor de columnas determinado. Para mejorar el rendimiento, compruebe primero el miembro pwszExt de la estructura a la que apunta pscd para ver si tiene una extensión de nombre de archivo compatible con el proveedor de columnas. Si no es así, evite el procesamiento innecesario devolviendo inmediatamente S_FALSE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj.h
Archivo DLL	Shell32.dll (versión 5.0 o posterior)