Fonction SHOpenFolderAndSelectItems (shlobj_core.h)

Article
03/04/2024

Ouvre une fenêtre Windows Explorer avec les éléments spécifiés dans un dossier particulier sélectionnés.

Syntaxe

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

Paramètres

[in] pidlFolder

Type : PCIDLIST_ABSOLUTE

Pointeur vers une liste d’ID d’élément complet qui spécifie le dossier.

cidl

Type : UINT

Nombre d’éléments dans le tableau de sélection, apidl. Si cidl a la valeur zéro, pidlFolder doit pointer vers un ITEMIDLIST entièrement spécifié décrivant un élément unique à sélectionner. Cette fonction ouvre le dossier parent et sélectionne cet élément.

[in, optional] apidl

Type : PCUITEMID_CHILD_ARRAY

Pointeur vers un tableau de structures PIDL, chacune d’elles étant un élément à sélectionner dans le dossier cible référencé par pidlFolder.

dwFlags

Type : DWORD

Indicateurs facultatifs. Sous Windows XP, ce paramètre est ignoré. Dans Windows Vista, les indicateurs suivants sont définis.

OFASI_EDIT (0x0001)

Sélectionnez un élément et placez son nom en mode édition. Cet indicateur ne peut être utilisé que lorsqu’un seul élément est sélectionné. Pour plusieurs sélections d’éléments, il est ignoré.

OFASI_OPENDESKTOP (0x0002)

Sélectionnez le ou les éléments sur le bureau plutôt que dans une fenêtre Windows Explorer. Notez que si le bureau est masqué derrière des fenêtres ouvertes, il ne sera pas rendu visible.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

CoInitialize ou CoInitializeEx doit être appelé avant d’utiliser SHOpenFolderAndSelectItems. Si vous ne le faites pas, SHOpenFolderAndSelectItems échoue.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 6.0 ou ultérieure)

Partager via