IShellBrowser::BrowseObject-Methode (shobjidl_core.h)
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) |