Metodo IExplorerBrowser::BrowseToObject (shobjidl_core.h)

Articolo
08/26/2023

Passa a un oggetto.

Sintassi

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

Parametri

[in] punk

Tipo: IUnknown*

Puntatore a un oggetto a cui passare. Se l'oggetto non può essere esplorato, viene restituito un valore di errore.

[in] uFlags

Tipo: UINT

Flag che specifica la categoria del pidl. Ciò influisce sul modo in cui viene eseguita la navigazione. Deve essere il valore zero o una combinazione bit per bit dei valori seguenti.

SBSP_ABSOLUTE

PiDL assoluto, rispetto al desktop.

SBSP_RELATIVE

PiDL relativo alla cartella corrente.

SBSP_PARENT

Esplorare la cartella padre, ignorare il PIDL.

SBSP_NAVIGATEBACK

Tornare indietro, ignorare il PIDL.

SBSP_NAVIGATEFORWARD

Passare avanti, ignorare il PIDL.

SBSP_KEEPWORDWHEELTEXT

Windows Vista e versioni successive. Questo flag indica che qualsiasi testo di ricerca immesso da wordWheel (casella di ricerca in Esplora risorse) deve essere mantenuto durante questo spostamento, in modo che gli elementi nella nuova posizione vengano filtrati nello stesso modo in cui sono stati filtrati nella posizione precedente.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

uFlags può essere uno dei EXPLORER_BROWSER_FILL_FLAGS o uno dei flag definiti nel parametro wFlags di BrowseObject, ad eccezione dei flag che indicano lo spostamento.

Questo metodo chiama GetIDList e passa al pidl restituito. Opera nello stesso modo di IExplorerBrowser::BrowseToIDList, ad eccezione del fatto che il punk non può essere NULL. L'utilizzo standard consiste nell'esplorare un oggetto IShellFolder o un oggetto IShellItem. Verrà restituito un errore se l'oggetto passato in non può essere esplorato. Un oggetto che può essere esplorato implementa IPersistFolder2 o IPersistIDList.

La prima navigazione di IExplorerBrowser è sincrona. In seguito, tutti gli spostamenti sono asincroni. Di conseguenza, le chiamate a IExplorerBrowser::BrowseToObject avranno esito positivo se si configura correttamente lo spostamento in sospeso, ma ciò non garantisce che la navigazione avrà esito positivo. Per essere informati sull'esito positivo e negativo, i client devono implementare IExplorerBrowserEvents e rispondere in modo appropriato in OnNavigationComplete e OnNavigationFailed.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Condividi tramite