Méthode IExplorerBrowser ::BrowseToObject (shobjidl_core.h)

Accède à un objet .

Syntaxe

HRESULT BrowseToObject(
  [in] IUnknown *punk,
  [in] UINT     uFlags
);

Paramètres

[in] punk

Type : IUnknown*

Pointeur vers un objet vers lequel accéder. Si l’objet ne peut pas être parcouru, une valeur d’erreur est retournée.

[in] uFlags

Type : UINT

Indicateur qui spécifie la catégorie du pidl. Cela affecte la façon dont la navigation est effectuée. Doit être la valeur zéro ou une combinaison au niveau du bit des valeurs suivantes.

SBSP_ABSOLUTE

PiDL absolu, relatif au bureau.

SBSP_RELATIVE

PiDL relatif, relatif au dossier actif.

SBSP_PARENT

Parcourez le dossier parent, ignorez le PIDL.

SBSP_NAVIGATEBACK

Revenez en arrière et ignorez le PIDL.

SBSP_NAVIGATEFORWARD

Naviguez vers l’avant, ignorez le PIDL.

SBSP_KEEPWORDWHEELTEXT

Windows Vista et versions ultérieures. Cet indicateur indique que tout texte de recherche entré par un objet WordWheel (la zone De recherche dans Windows Explorer) doit être conservé pendant cette navigation, de sorte que les éléments du nouvel emplacement soient filtrés de la même façon qu’ils l’ont été à l’emplacement précédent.

Valeur retournée

Type : HRESULT

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

Remarques

uFlags peut être l’un des EXPLORER_BROWSER_FILL_FLAGS ou l’un des indicateurs définis dans le paramètre wFlags de BrowseObject, à l’exception des indicateurs qui indiquent la navigation.

Cette méthode appelle GetIDList et accède au pidl retourné. Il fonctionne de la même façon que IExplorerBrowser ::BrowseToIDList, sauf que punk ne peut pas être NULL. L’utilisation standard consiste à accéder à un IShellFolder ou un IShellItem. Une erreur est retournée si l’objet transmis ne peut pas être parcouru. Un objet qui peut être parcouru implémente IPersistFolder2 ou IPersistIDList.

La première navigation de IExplorerBrowser est synchrone. Après cela, toutes les navigations sont asynchrones. Par conséquent, les appels à IExplorerBrowser ::BrowseToObject réussissent si vous configurez correctement la navigation en attente, mais cela ne garantit pas la réussite de la navigation. Pour être informés de la réussite et de l’échec, les clients doivent implémenter IExplorerBrowserEvents et répondre de manière appropriée dans OnNavigationComplete et OnNavigationFailed.

Configuration requise