Metodo IColumnProvider::GetItemData (shlobj.h)

Articolo
03/13/2024

Richiede dati di colonna per un file specificato.

Sintassi

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

Parametri

[in] pscid

Tipo: LPCSHCOLUMNID

Struttura SHCOLUMNID che identifica la colonna.

[in] pscd

Tipo: LPCSHCOLUMNDATA

Struttura SHCOLUMNDATA che specifica il file.

[out] pvarData

Tipo: VARIANT*

Puntatore a un valore VARIANT con i dati per il file specificato da pscd che appartiene alla colonna specificata da pscid. Impostare questo valore se il file è un membro della classe supportata dal provider di colonne.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se i dati del file vengono restituiti, S_FALSE se il file non è supportato dal provider di colonne e non vengono restituiti dati o un valore di errore COM in caso contrario.

Commenti

Questo metodo viene chiamato per recuperare i dati per la visualizzazione di un file nella colonna specificata. Deve essere thread-safe.

Questo metodo viene chiamato per ogni file visualizzato da Esplora risorse, anche se molti di essi non saranno supportati da un determinato provider di colonne. Per migliorare le prestazioni, controllare prima di tutto il membro pwszExt della struttura puntata da pscd per verificare se ha un'estensione del nome file supportata dal provider di colonne. In caso contrario, evitare l'elaborazione non necessaria restituendo immediatamente S_FALSE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj.h
DLL	Shell32.dll (versione 5.0 o successiva)

Condividi tramite