IShellFolderView::GetSelectedObjects-Methode (shlobj_core.h)

Artikel
03/04/2024

[Diese Methode ist veraltet. Verwenden Sie stattdessen IFolderView2::GetSelection .]

Ruft ein Array der ausgewählten Objekte in der Ansicht und die Anzahl dieser Objekte ab.

Syntax

HRESULT GetSelectedObjects(
  [out] PCUITEMID_CHILD **pppidl,
  [out] UINT            *puItems
);

Parameter

[out] pppidl

Typ: PCUITEMID_CHILD**

Die Adresse eines Zeigers, der bei erfolgreicher Rückgabe dieser Methode auf ein Array der aktuell ausgewählten Elemente in der Ansicht verweist. Es wird erwartet, dass die aufrufende Anwendung das Array bei pppidl mithilfe von LocalFree frei gibt. Die aufrufende Anwendung darf die einzelnen Elemente, die im Array enthalten sind, nicht freigeben.

[out] puItems

Typ: UINT*

Ein Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Methode die Anzahl der Elemente im pppidl-Array empfängt .

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Methode stellt konstante Zeiger auf interne Datenstrukturen bereit. Es wird erwartet, dass die aufrufende Anwendung sofort auf sie reagiert und nicht zwischengespeichert wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h

Freigeben über