IColumnProvider::GetItemData-Methode (shlobj.h)

Fordert Spaltendaten für eine angegebene Datei an.

Syntax

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

Parameter

[in] pscid

Typ: LPCSHCOLUMNID

Eine SHCOLUMNID-Struktur , die die Spalte identifiziert.

[in] pscd

Typ: LPCSHCOLUMNDATA

Eine SHCOLUMNDATA-Struktur , die die Datei angibt.

[out] pvarData

Typ: VARIANT*

Ein Zeiger auf einen VARIANT-Wert mit den Daten für die von pscd angegebene Datei, die in die von pscid angegebene Spalte gehört. Legen Sie diesen Wert fest, wenn die Datei ein Member der klasse ist, die vom Spaltenanbieter unterstützt wird.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn Dateidaten zurückgegeben werden, S_FALSE, wenn die Datei vom Spaltenanbieter nicht unterstützt wird und keine Daten zurückgegeben werden, oder andernfalls ein COM-Fehlerwert.

Hinweise

Diese Methode wird aufgerufen, um die Daten für eine Datei abzurufen, die in der angegebenen Spalte angezeigt werden soll. Es sollte threadsicher sein.

Diese Methode wird für jede Datei aufgerufen, die von Windows Explorer angezeigt wird, auch wenn viele von ihnen von einem bestimmten Spaltenanbieter nicht unterstützt werden. Um die Leistung zu verbessern, überprüfen Sie zunächst den pwszExt-Member der Struktur, auf die pscd verweist, um festzustellen, ob es über eine Dateinamenerweiterung verfügt, die vom Spaltenanbieter unterstützt wird. Wenn nicht, vermeiden Sie unnötige Verarbeitung, indem Sie sofort S_FALSE zurückgeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj.h
DLL	Shell32.dll (Version 5.0 oder höher)