IShellDetails::GetDetailsOf-Methode (shlobj_core.h)

Ruft detaillierte Informationen zu einem Element in einem Shellordner ab.

Syntax

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

Parameter

[in, optional] pidl

Typ: PCUITEMID_CHILD

Die PIDL des Elements, für das Sie Informationen anfordern. Wenn dieser Parameter auf NULL festgelegt ist, wird der Titel des von iColumn angegebenen Informationsfelds in der SHELLDETAILS-Struktur zurückgegeben, auf die von pDetails verwiesen wird.

iColumn

Typ: UINT

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

[out] pDetails

Typ: SHELLDETAILS*

Ein Zeiger auf eine SHELLDETAILS-Struktur mit den Detailinformationen.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt E_FAIL zurück, wenn iColumn die Anzahl der Spalten überschreitet, die vom Ordner unterstützt werden. Andernfalls wird ein COM-Standardfehlercode zurückgegeben.

Hinweise

Diese Methode wurde von den IShellFolder2-Methoden für Shell Version 5.0 und höher abgelöst.

Die IShellDetails::GetDetailsOf-Methode bietet Zugriff auf die Informationen, die in der Windows Explorer Detailansicht eines Shellordners angezeigt werden. Die Spaltennummern, Spaltentitel und Elementinformationen, die in der Detailansicht angezeigt werden, sind identisch mit denen, die von IShellDetails::GetDetailsOf zurückgegeben werden.

Die verfügbaren Informationsfelder und deren Spaltennummern variieren je nach Ordner. Rufen Sie zum Aufzählen der verfügbaren Felder IShellDetails::GetDetailsOf auf, wobei pidl zum Erhöhen der Werte von iColumn auf NULL festgelegt ist. Dieser Ansatz bietet Ihnen den Titel, der jedem Spaltenindex zugeordnet ist. Wenn iColumn die Anzahl der Spalten überschreitet, die vom Ordner unterstützt werden, gibt IShellDetails::GetDetailsOf E_FAIL zurück. Beachten Sie, dass diese Titel lokalisierbar sind 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.

Dateisystemordner unterstützen möglicherweise eine Reihe zusätzlicher Felder. 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. In der Regel befindet sich der Anzeigename des Elements in spalte null, aber die Reihenfolge und der Inhalt der verfügbaren Felder hängen von der Implementierung des jeweiligen Ordnerobjekts ab.

Hinweis zu Implementern

Anforderungen