Metodo IShellDetails::GetDetailsOf (shlobj_core.h)

Articolo
08/26/2023

Ottiene informazioni dettagliate su un elemento in una cartella shell.

Sintassi

HRESULT GetDetailsOf(
  [in, optional] PCUITEMID_CHILD pidl,
                 UINT            iColumn,
  [out]          SHELLDETAILS    *pDetails
);

Parametri

[in, optional] pidl

Tipo: PCUITEMID_CHILD

IL FILE PIDL dell'elemento per cui si richiedono informazioni. Se questo parametro è impostato su NULL, il titolo del campo informazioni specificato da iColumn verrà restituito nella struttura SHELLDETAILS a cui punta pDetails.

iColumn

Tipo: UINT

Indice in base zero del campo delle informazioni desiderate. È identico al numero di colonna delle informazioni visualizzate in una visualizzazione Dettagli di Esplora risorse.

[out] pDetails

Tipo: SHELLDETAILS*

Puntatore a una struttura SHELLDETAILS con le informazioni dettagliate.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo. Restituisce E_FAIL se iColumn supera il numero di colonne supportate dalla cartella. In caso contrario, restituisce un codice di errore COM standard.

Commenti

Questo metodo è stato sostituito dai metodi IShellFolder2 per Shell versione 5.0 e successive.

Il metodo IShellDetails::GetDetailsOf consente di accedere alle informazioni visualizzate nella visualizzazione Dettagli esplora risorse di una cartella shell. I numeri di colonna, i titoli delle colonne e le informazioni sugli elementi visualizzati nella visualizzazione Dettagli sono identici a quelli restituiti da IShellDetails::GetDetailsOf.

I campi delle informazioni disponibili e i relativi numeri di colonna variano a seconda della cartella specifica. Per enumerare i campi disponibili, chiamare IShellDetails::GetDetailsOf con pidl impostato su NULL per aumentare i valori di iColumn. Questo approccio fornisce il titolo associato a ogni indice di colonna. Quando iColumn supera il numero di colonne supportate dalla cartella, IShellDetails::GetDetailsOf restituirà E_FAIL. Tenere presente che questi titoli sono localizzabili e potrebbero non essere uguali per tutte le impostazioni locali.

Le cartelle del file system hanno un ampio set standard di campi di informazioni. I primi quattro campi sono standard per tutte le cartelle del file system.

Indice di colonna	Titolo colonna
0	Nome
1	Dimensione
2	Tipo
3	Data ultima modifica

Le cartelle del file system possono supportare diversi campi aggiuntivi. Non è tuttavia necessario eseguire questa operazione e gli indici di colonna assegnati a questi campi possono variare.

Ogni cartella virtuale ha un proprio set univoco di campi di informazioni. In genere, il nome visualizzato dell'elemento è in colonna zero, ma l'ordine e il contenuto dei campi disponibili dipendono dall'implementazione dell'oggetto cartella specifico.

Nota per gli implementatori

Gli oggetti cartella devono implementare IShellFolder2 anziché questa interfaccia.

Requisiti

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

Condividi tramite