ITrackShellMenu::GetShellFolder Method

Gets the folder that the menu band is set to browse.

Syntax

HRESULT GetShellFolder(      
    DWORD *pdwFlags,
    PCIDLIST_ABSOLUTE *pidlFolder,
    REFIID riid,
    void **ppv
);

Parameters

  • pdwFlags
    [out] When this method returns successfully, contains a pointer to the value of the flags that specify how the menu band operates. -
    May return any of the following flags. - SMINIT_DEFAULT
    No options. - SMINIT_RESTRICT_DRAGDROP
    Don't allow drag-and-drop. - SMINIT_TOPLEVEL
    This is the top band. - SMINIT_CACHED
    Do not destroy the band when the window is closed. -

    • Use only one of the following flags.
      • SMINIT_VERTICAL
        Specifies a vertical band.
      • SMINIT_HORIZONTAL
        Specifies a horizontal band.
  • pidlFolder
    [out] When this method returns, contains the address of the folder's fully-qualified ITEMIDLIST.

  • riid
    [in] The REFIID for the target folder.

  • ppv
    [out] When this method returns successfully, contains the address of a pointer to the Shell folder object referenced by the riid.

Return Value

Returns S_OK if successful, or an error value otherwise.