BROWSEINFO (Compact 2013)

3/28/2014

This structure receives information about a folder selected by the user in a dialog box that an application created by calling the SHBrowseForFolder function.

Syntax

typedef struct _browseinfo {
  HWND hwndOwner;
  LPCITEMIDLIST pidlRoot;
  LPTSTR pszDisplayName;
  LPCTSTR lpszTitle;
  UINT ulFlags;
  BFFCALLBACK lpfn;
  LPARAM lParam;
  int iImage;
} BROWSEINFO, *PBROWSEINFO, *LPBROWSEINFO;

Members

  • hwndOwner
    Handle to the window that owns the dialog box.
  • pidlRoot
    Pointer to an ITEMIDLIST structure (PIDL) that specifies the location of the root folder from which to start browsing. Only the specified folder and any subfolders that are beneath the specified folder in the namespace hierarchy appear in the dialog box. This member can be NULL; in that case, the namespace root is used.
  • pszDisplayName
    Pointer to a buffer that receives the display name of the folder that the user selects. The size of this buffer is assumed to be MAX_PATH bytes.
  • lpszTitle
    Pointer to a null-terminated string that is displayed above the tree view control in the dialog box. You can use this string to specify instructions to the user.
  • ulFlags
    Unsigned integer that specifies the options for the dialog box. This member can include a zero or a combination of values. The following table shows the possible values.

    Value

    Description

    BIF_EDITBOX

    Includes an edit control in the Browse For Folder dialog box that allows the user to type the name of an item.

    BIF_STATUSTEXT

    Includes a status area in the dialog box. The callback function can set the status text by sending a BFFM_SETSTATUSTEXT message to the dialog box.

    BIF_VALIDATE

    Calls the BrowseCallbackProc function for the application with the BFFM_VALIDATEFAILED message if the user types an invalid name into the edit box. This value is ignored if you do not specify BIF_EDITBOX.

  • lpfn
    Pointer to an application-defined function that the dialog box calls when an event occurs. For more information, see the BrowseCallbackProc function. This member can be NULL.
  • lParam
    Application-defined value that the dialog box passes to the callback function, if you specify a callback function.
  • iImage
    Integer that receives an index for the image associated with the selected folder. The image is specified as an index to the system image list.

Requirements

Header

shlobj.h

See Also

Reference

Shell Structures
BrowseCallbackProc
SHBrowseForFolder
ITEMIDLIST