IDataPathBrowser::BrowseType

IDataPathBrowser::BrowseType

Instructs the browser to invoke a browsing user interface for the type identified with rguidPathType, if the user interface is available. If the user selects a path to data from within the user interface, the browser should return the string for that path in pszPath.

HRESULT BrowseType(

    REFGUID

rguidPathType,            // GUID identifying the data type to browse

    LPOLESTR  pszDefaultType,          // Default path string to display in the browsing user interface

    ULONG  cchPath,                    // Size of buffer pointed to by pszPath

    LPOLESTR  pszPath,                 // Receives the selected string

    HWND   hWnd                        // Parent window of the browsing user interface

);

Parameters

rguidPathType

[in] The GUID identifying the data type to browse.

pszDefaultPath

[in] The default path string to display in the browsing user interface.

cchPath

[in] The size of the buffer pointed to by pszPath.

pszPath

[out] The buffer to receive the selected string if the browsing is successful.

hWnd

[in] The window that should be the parent of the browsing user interface.

Return Values

S_OK

The browsing user interface was successfully displayed and a new path is returned in pszPath.

S_FALSE

The browsing user interface was successfully displayed but the user did not select a path (for example, the user may have pressed Cancel).

E_OUTOFMEMORY

There was not enough memory to display the user interface, but the browsing user interface is available.

E_FAIL

The site does not support browsing for the type specified in rguidPathType.

Remarks

E_NOTIMPL is not allowedwithout implementing the BrowseType method, the IDataPathBrowser interface is unnecessary.