SHOpenFolderAndSelectItems function (shlobj_core.h)
Opens a Windows Explorer window with specified items in a particular folder selected.
Syntax
SHSTDAPI SHOpenFolderAndSelectItems(
[in] PCIDLIST_ABSOLUTE pidlFolder,
UINT cidl,
[in, optional] PCUITEMID_CHILD_ARRAY apidl,
DWORD dwFlags
);
Parameters
[in] pidlFolder
Type: PCIDLIST_ABSOLUTE
A pointer to a fully qualified item ID list that specifies the folder.
cidl
Type: UINT
A count of items in the selection array, apidl. If cidl is zero, then pidlFolder must point to a fully specified ITEMIDLIST describing a single item to select. This function opens the parent folder and selects that item.
[in, optional] apidl
Type: PCUITEMID_CHILD_ARRAY
A pointer to an array of PIDL structures, each of which is an item to select in the target folder referenced by pidlFolder.
dwFlags
Type: DWORD
The optional flags. Under Windows XP this parameter is ignored. In Windows Vista, the following flags are defined.
OFASI_EDIT (0x0001)
Select an item and put its name in edit mode. This flag can only be used when a single item is being selected. For multiple item selections, it is ignored.
OFASI_OPENDESKTOP (0x0002)
Select the item or items on the desktop rather than in a Windows Explorer window. Note that if the desktop is obscured behind open windows, it will not be made visible.
Return value
Type: HRESULT
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
CoInitialize or CoInitializeEx must be called before using SHOpenFolderAndSelectItems. Not doing so causes SHOpenFolderAndSelectItems to fail.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | shlobj_core.h (include Shlobj.h) |
Library | Shell32.lib |
DLL | Shell32.dll (version 6.0 or later) |
Σχόλια
https://aka.ms/ContentUserFeedback.
Σύντομα διαθέσιμα: Καθ' όλη τη διάρκεια του 2024 θα καταργήσουμε σταδιακά τα ζητήματα GitHub ως μηχανισμό ανάδρασης για το περιεχόμενο και θα το αντικαταστήσουμε με ένα νέο σύστημα ανάδρασης. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα:Υποβολή και προβολή σχολίων για