IShellFolder2::GetDetailsEx-Methode (shobjidl_core.h)

  • Artikel

Ruft detaillierte Informationen zu einem Element in einem Shellordner ab, die durch einen Eigenschaftssatzbezeichner (Property Set Identifier, FMTID) und einen Eigenschaftsbezeichner (PID) identifiziert werden.

Syntax

HRESULT GetDetailsEx(
  [in]  PCUITEMID_CHILD  pidl,
  [in]  const SHCOLUMNID *pscid,
  [out] VARIANT          *pv
);

Parameter

[in] pidl

Typ: PCUITEMID_CHILD

Eine PIDL des Elements relativ zum übergeordneten Ordner. Diese Methode akzeptiert nur PIDLs auf einer Ebene. Die -Struktur muss genau eine SHITEMID-Struktur gefolgt von einer endenden Null enthalten. Dieser Wert darf nicht NULL sein.

[in] pscid

Typ: const SHCOLUMNID*

Ein Zeiger auf eine SHCOLUMNID-Struktur , die die Spalte identifiziert.

[out] pv

Typ: VARIANT*

Ein Zeiger auf einen VARIANT-Wert mit den angeforderten Informationen. Der Wert ist vollständig typisiert. Der wert, der für Eigenschaften aus dem Eigenschaftensystem zurückgegeben wird, muss dem typ entsprechen, der in der typeInfo dieser Eigenschaftsdefinition als legacyType-Attribut angegeben ist.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Funktion ist eine robustere Version von IShellFolder2::GetDetailsOf. Sie bietet Zugriff auf die Informationen, die in der Ansicht Windows Explorer Details eines Shellordners angezeigt werden. Der Hauptunterschied besteht darin, dass Sie mit GetDetailsEx die Spalte mit einer FMTID - und PID-Struktur identifizieren können, anstatt zuerst den Spaltenindex bestimmen zu müssen.

Anforderungen

   
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)