IShellBrowser::BrowseObject-Methode (shobjidl_core.h)

  • Artikel

Informiert Windows Explorer, zu einem anderen Ordner zu navigieren.

Syntax

HRESULT BrowseObject(
  PCUIDLIST_RELATIVE pidl,
  UINT               wFlags
);

Parameter

pidl

Typ: PCUIDLIST_RELATIVE

Die Adresse einer ITEMIDLIST-Struktur (Elementbezeichnerliste), die den Speicherort eines Objekts angibt. Dieser Wert ist abhängig von den Flags, die im wFlags-Parameter festgelegt sind.

wFlags

Typ: UINT

Flags, die den zu durchsuchenden Ordner angeben. Es kann null oder mindestens einer der folgenden Werte sein.

Diese Flags geben an, ob ein weiteres Fenster erstellt werden soll.

SBSP_DEFBROWSER (0x0000)

Verwenden Sie das Standardverhalten, das die Ansichtsoption berücksichtigt (die Benutzereinstellung, um neue Fenster zu erstellen oder direkt zu durchsuchen). In den meisten Fällen sollten aufrufende Anwendungen dieses Flag verwenden.

SBSP_SAMEBROWSER

Navigieren Sie zu einem anderen Ordner mit demselben Windows Explorer Fenster.

SBSP_NEWBROWSER

Erstellt ein weiteres Fenster für den angegebenen Ordner.

Die folgenden Flags geben den Modus an. Diese Werte werden ignoriert, wenn SBSP_SAMEBROWSER angegeben ist oder wenn SBSP_DEFBROWSER angegeben ist und der Benutzer Direkt durchsuchen ausgewählt hat.

SBSP_DEFMODE

Verwenden Sie das aktuelle Fenster.

SBSP_OPENMODE

Gibt keine Ordnerstruktur für das neue Suchfenster an. Wenn der aktuelle Browser nicht mit dem SBSP_OPENMODE des Aufrufs des Suchobjekts übereinstimmt, wird ein neues Fenster geöffnet.

SBSP_EXPLOREMODE

Gibt eine Ordnerstruktur für das neue Suchfenster an. Wenn der aktuelle Browser nicht mit dem SBSP_EXPLOREMODE des Aufrufs des Suchobjekts übereinstimmt, wird ein neues Fenster geöffnet.

SBSP_HELPMODE

Wird nicht unterstützt. Darf nicht verwendet werden.

SBSP_NOTRANSFERHIST

Übertragen Sie den Browserverlauf nicht in das neue Fenster.

Die folgenden Flags geben die Kategorie des pidl-Parameters an.

SBSP_ABSOLUTE

Eine absolute PIDL relativ zum Desktop.

SBSP_RELATIVE

Eine relative PIDL relativ zum aktuellen Ordner.

SBSP_PARENT

Durchsuchen Sie den übergeordneten Ordner, und ignorieren Sie die PIDL.

SBSP_NAVIGATEBACK

Navigieren Sie zurück, und ignorieren Sie die PIDL.

SBSP_NAVIGATEFORWARD

Navigieren Sie vorwärts, und ignorieren Sie die PIDL.

SBSP_ALLOW_AUTONAVIGATE (0x00010000)

Aktivieren Sie die automatische Navigation.

Die folgenden Flags geben den Modus an.

SBSP_KEEPSAMETEMPLATE (0x00020000)

Windows Vista und höher. Wird nicht unterstützt. Darf nicht verwendet werden.

SBSP_KEEPWORDWHEELTEXT (0x00040000)

Windows Vista und höher. Navigieren Sie, ohne das Sucheingabefeld zu löschen.

SBSP_ACTIVATE_NOFOCUS (0x00080000)

Windows Vista und höher. Navigieren Sie ohne das Standardverhalten, den Fokus in der neuen Ansicht festzulegen.

Die folgenden Flags steuern, wie der Verlauf als Ergebnis der Navigation bearbeitet wird.

SBSP_CALLERUNTRUSTED (0x00800000)

Microsoft Internet Explorer 6 Service Pack 2 (SP2) und höher. Die Navigation wurde möglicherweise von einer Webseite mit Skriptcode initiiert, der bereits auf dem lokalen System vorhanden ist.

SBSP_TRUSTFIRSTDOWNLOAD (0x01000000)

Microsoft Internet Explorer 6 Service Pack 2 (SP2) und höher. Das neue Fenster ist das Ergebnis einer vom Benutzer initiierten Aktion. Vertrauen Sie dem neuen Fenster, wenn es sofort versucht, Inhalte herunterzuladen.

SBSP_UNTRUSTEDFORDOWNLOAD (0x02000000)

Microsoft Internet Explorer 6 Service Pack 2 (SP2) und höher. Das Fenster navigiert zu einer nicht vertrauenswürdigen Nicht-HTML-Datei. Wenn der Benutzer versucht, die Datei herunterzuladen, lassen Sie den Download nicht zu.

SBSP_NOAUTOSELECT

Unterdrücken sie die Auswahl im Verlaufsbereich.

SBSP_WRITENOHISTORY

Schreiben Sie keinen Verlauf dieser Navigation in den Shellordner "Verlauf".

SBSP_CREATENOHISTORY (0x00100000)

0x00100000. Windows 7 und höher. Fügen Sie dem Reiseprotokoll keinen neuen Eintrag hinzu. Wenn der Benutzer einen Suchbegriff in das Suchfeld eingibt und die Abfrage anschließend verfeinern wird, navigiert der Browser vorwärts, fügt jedoch keinen zusätzlichen Reiseprotokolleintrag hinzu.

SBSP_TRUSTEDFORACTIVEX (0x10000000)

Microsoft Internet Explorer 6 Service Pack 2 (SP2) und höher. Die Navigation sollte ActiveX-Eingabeaufforderungen zulassen.

SBSP_FEEDNAVIGATION (0x20000000)

Windows Internet Explorer 7 und höher. Wenn die aktuellen Registrierungseinstellungen dies zulassen, geben Sie dem Browser ein Ziel, zu dem er navigieren kann.

SBSP_REDIRECT (0x40000000)

Aktiviert die Umleitung zu einer anderen URL.

SBSP_INITIATEDBYHLINKFRAME (0x80000000)

SBSP_PLAYNOSOUND (0x00200000)

Windows 7 und höher. Machen Sie nicht den vollständigen Sound der Navigation für jede Tastenkombination im Suchfeld.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Ansichten können diese Methode verwenden, um windows Explorer zu erzwingen, zu einer bestimmten Stelle im Namespace zu navigieren. In der Regel handelt es sich dabei um Ordner, die in der Ansicht enthalten sind.

Beispiele

IShellBrowser* psb;
hr = IUnknown_QueryService(punkSite, SID_STopLevelBrowser, IID_PPV_ARGS(&psb));

if (SUCCEEDED(hr))
{
    hr = psb->BrowseObject(pidlSearch, SBSP_DEFBROWSER | SBSP_ABSOLUTE);
    psb->Release();
}

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)
DLL Shell32.dll (Version 4.0 oder höher)

Weitere Informationen

IShellBrowser