Partager via

Méthode IShellMenu ::GetShellFolder (shobjidl_core.h)

  • Article

Obtient le dossier que la bande de menus est définie pour parcourir.

Syntaxe

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

Paramètres

[out] pdwFlags

Type : DWORD*

Lorsque cette méthode retourne correctement, contient un pointeur vers un ensemble de valeurs d’indicateur qui spécifient le fonctionnement de la bande de menus.

Peut retourner l’un des indicateurs suivants.

Valeur Signification
SMINIT_DEFAULT
 Aucune option.
SMINIT_RESTRICT_DRAGDROP
 N’autorisez pas le glisser-déplacer.
SMINIT_TOPLEVEL
 C’est la bande supérieure.
SMINIT_CACHED
 Ne détruisez pas la bande lorsque la fenêtre est fermée.
 

Retourne toujours l’un des indicateurs suivants.

Valeur Signification
SMINIT_VERTICAL
 Spécifie une bande verticale.
SMINIT_HORIZONTAL
 Spécifie une bande horizontale.

[out] ppidl

Type : PCIDLIST_ABSOLUTE*

Lorsque cette méthode est retournée, contient l’adresse de l’itemIDLIST complet du dossier.

[in] riid

Type : REFIID

REFIID du dossier cible.

[out] ppv

Type : void**

Lorsque cette méthode retourne correctement, contient l’adresse d’un pointeur vers l’objet de dossier Shell référencé par le riid.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise Valeur
Client minimal pris en charge Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)
DLL Shell32.dll