IShellFolder2::GetDetailsOf-Methode (shobjidl_core.h)

  • Artikel

Ruft detaillierte Informationen ab, die durch einen Spaltenindex identifiziert werden, zu einem Element in einem Shellordner.

Syntax

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

Parameter

[in] pidl

Typ: PCUITEMID_CHILD

PIDL des Elements, für das Sie Informationen anfordern. Diese Methode akzeptiert nur PIDLs auf einer Ebene. Die -Struktur muss genau eine SHITEMID-Struktur gefolgt von einer endenden Null enthalten. Wenn dieser Parameter auf NULL festgelegt ist, wird der Titel des von iColumn angegebenen Informationsfelds zurückgegeben.

[in] iColumn

Typ: UINT

Der nullbasierte Index des gewünschten Informationsfelds. Sie ist identisch mit der Spaltennummer der Informationen, wie sie in einer Windows Explorer Detailansicht angezeigt wird.

[out] psd

Typ: SHELLDETAILS*

Ein Zeiger auf eine SHELLDETAILS-Struktur , die die Informationen enthält.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die IShellFolder2::GetDetailsOf-Methode ist identisch mit GetDetailsOf. Verwenden Sie IShellFolder2::GetDetailsEx, um Eine robustere Methode zum Abrufen von Elementinformationen zu erhalten, für die Sie den Spaltenindex nicht kennen müssen.

Die IShellFolder2::GetDetailsOf-Methode bietet Zugriff auf die Informationen, die in der Windows Explorer Detailansicht eines Shellordners angezeigt werden. Die Spaltennummern, Überschriften und Informationen, die in der Detailansicht angezeigt werden, sind mit denen von IShellFolder2::GetDetailsOf identisch. Beachten Sie, dass die verfügbaren Informationsfelder und deren Spaltennummern abhängig vom jeweiligen Ordner variieren. Sie können die verfügbaren Felder aufzählen, indem Sie diese Methode aufrufen, wobei pidl auf NULL festgelegt ist, und den Titel untersuchen, der jedem Spaltenindex zugeordnet ist. Beachten Sie, dass diese Titel lokalisiert werden können und möglicherweise nicht für alle Gebietsschemas identisch sind.

Dateisystemordner verfügen über einen großen Standardsatz von Informationsfeldern. Die ersten vier Felder sind standard für alle Dateisystemordner.

Spaltenindex Spaltentitel
0 Name
1 Size
2 Typ
3 Änderungsdatum
 

Dateisystemordner können eine Reihe zusätzlicher Felder unterstützen. Dies ist jedoch nicht erforderlich, und die spaltenbasierten Indizes, die diesen Feldern zugewiesen sind, können variieren.

Jeder virtuelle Ordner verfügt über einen eigenen, eindeutigen Satz von Informationsfeldern. Normalerweise befindet sich der Anzeigename des Elements in Spalte 0, aber die Reihenfolge und der Inhalt der verbleibenden Felder hängen von der Implementierung des jeweiligen Ordnerobjekts ab.

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 shobjidl_core.h (shobjidl.h einschließen)
DLL Shell32.dll (Version 5.0 oder höher)