SHOpenFolderAndSelectItems-Funktion (shlobj_core.h)

Artikel
03/02/2024

Öffnet ein Windows-Explorer-Fenster, in dem die angegebenen Elemente in einem bestimmten Ordner ausgewählt sind.

Syntax

SHSTDAPI SHOpenFolderAndSelectItems(
  [in]           PCIDLIST_ABSOLUTE     pidlFolder,
                 UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
                 DWORD                 dwFlags
);

Parameter

[in] pidlFolder

Typ: PCIDLIST_ABSOLUTE

Ein Zeiger auf eine vollqualifizierte Element-ID-Liste, die den Ordner angibt.

cidl

Typ: UINT

Die Anzahl der Elemente im Auswahlarray apidl. Wenn cidl null ist, muss pidlFolder auf eine vollständig angegebene ITEMIDLIST zeigen, die ein einzelnes element beschreibt, das ausgewählt werden soll. Diese Funktion öffnet den übergeordneten Ordner und wählt dieses Element aus.

[in, optional] apidl

Typ: PCUITEMID_CHILD_ARRAY

Ein Zeiger auf ein Array von PIDL-Strukturen, von denen jede ein Element ist, das im Zielordner ausgewählt werden soll, auf den pidlFolder verweist.

dwFlags

Art: DWORD

Die optionalen Flags. Unter Windows XP wird dieser Parameter ignoriert. In Windows Vista werden die folgenden Flags definiert.

OFASI_EDIT (0x0001)

Wählen Sie ein Element aus, und legen Sie dessen Namen in den Bearbeitungsmodus. Dieses Flag kann nur verwendet werden, wenn ein einzelnes Element ausgewählt wird. Bei mehreren Elementauswahlen wird sie ignoriert.

OFASI_OPENDESKTOP (0x0002)

Wählen Sie die Elemente auf dem Desktop und nicht in einem Windows-Explorer-Fenster aus. Beachten Sie, dass der Desktop nicht sichtbar gemacht wird, wenn er hinter geöffneten Fenstern verdeckt wird.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

CoInitialize oder CoInitializeEx muss aufgerufen werden, bevor SHOpenFolderAndSelectItems verwendet wird. Dies führt dazu, dass SHOpenFolderAndSelectItems fehlschlägt .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (einschließlich Shlobj.h)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 6.0 oder höher)

Share via