IShellMenu::GetShellFolder-Methode (shobjidl_core.h)

Artikel
08/26/2023

Ruft den Ordner ab, den das Menüband durchsuchen soll.

Syntax

HRESULT GetShellFolder(
  [out] DWORD            *pdwFlags,
  [out] PIDLIST_ABSOLUTE *ppidl,
  [in]  REFIID           riid,
  [out] void             **ppv
);

Parameter

[out] pdwFlags

Typ: DWORD*

Wenn diese Methode erfolgreich zurückgegeben wird, enthält einen Zeiger auf einen Satz von Flagwerten, die angeben, wie das Menüband funktioniert.

Kann jedes der folgenden Flags zurückgeben.

Wert	Bedeutung
SMINIT_DEFAULT	Keine Optionen.
SMINIT_RESTRICT_DRAGDROP	Drag-and-Drop nicht zulassen.
SMINIT_TOPLEVEL	Dies ist die top Band.
SMINIT_CACHED	Zerstören Sie das Band nicht, wenn das Fenster geschlossen wird.

Gibt immer eines der folgenden Flags zurück.

Wert	Bedeutung
SMINIT_VERTICAL	Gibt ein vertikales Band an.
SMINIT_HORIZONTAL	Gibt ein horizontales Band an.

[out] ppidl

Typ: PCIDLIST_ABSOLUTE*

Wenn diese Methode zurückgibt, enthält die Adresse der vollqualifizierten ITEMIDLIST des Ordners.

[in] riid

Typ: REFIID

Die REFIID für den Zielordner.

[out] ppv

Typ: void**

Wenn diese Methode erfolgreich zurückgibt, enthält die Adresse eines Zeigers auf das Shell-Ordnerobjekt, auf das vom riid verwiesen wird.

Rückgabewert

Typ: HRESULT

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [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

Share via