Metodo IShellFolder2::GetDetailsOf (shobjidl_core.h)

Articolo
03/02/2024

Ottiene informazioni dettagliate, identificate da un indice di colonna, su un elemento in una cartella shell.

Sintassi

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

Parametri

[in] pidl

Tipo: PCUITEMID_CHILD

PIDL dell'elemento per il quale si richiedono informazioni. Questo metodo accetta solo PIDL a livello singolo. La struttura deve contenere esattamente una struttura SHITEMID seguita da uno zero terminante. Se questo parametro è impostato su NULL, viene restituito il titolo del campo informazioni specificato da iColumn .

[in] iColumn

Tipo: UINT

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

[out] psd

Tipo: SHELLDETAILS*

Puntatore a una struttura SHELLDETAILS contenente le informazioni.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il metodo IShellFolder2::GetDetailsOf è identico a GetDetailsOf. Per un modo più affidabile per recuperare le informazioni sull'elemento che non richiedono di conoscere l'indice di colonna, usare IShellFolder2::GetDetailsEx.

Il metodo IShellFolder2::GetDetailsOf fornisce l'accesso alle informazioni visualizzate nella visualizzazione Dettagli esplora windows di una cartella shell. I numeri di colonna, le intestazioni e le informazioni visualizzate nella visualizzazione Dettagli sono identici a quelli di IShellFolder2::GetDetailsOf. Si noti che i campi informazioni disponibili e i relativi numeri di colonna variano a seconda della cartella specifica. È possibile enumerare i campi disponibili chiamando questo metodo con pidl impostato su NULL e esaminando il titolo associato a ogni indice di colonna. Tenere presente che questi titoli possono essere localizzati e potrebbero non essere uguali per tutte le impostazioni locali.

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

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

Le cartelle del file system possono supportare un numero di campi aggiuntivi. Tuttavia, non sono necessari a tale scopo e gli indici di colonna assegnati a questi campi potrebbero variare.

Ogni cartella virtuale ha un proprio set univoco di campi informativi. Normalmente, il nome visualizzato dell'elemento è in colonna zero, ma l'ordine e il contenuto dei campi rimanenti dipendono dall'implementazione dell'oggetto della cartella specifica.

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	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 5.0 o successiva)

Condividi tramite