Funzione SHOpenFolderAndSelectItems (shlobj_core.h)

Apre una finestra di Esplora risorse con gli elementi specificati in una determinata cartella selezionata.

Sintassi

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

Parametri

[in] pidlFolder

Tipo: PCIDLIST_ABSOLUTE

Puntatore a un elenco di ID elemento completo che specifica la cartella.

cidl

Tipo: UINT

Conteggio degli elementi nella matrice di selezione , apidl. Se cidl è zero, pidlFolder deve puntare a un ITEMIDLIST completamente specificato che descrive un singolo elemento da selezionare. Questa funzione apre la cartella padre e seleziona tale elemento.

[in, optional] apidl

Tipo: PCUITEMID_CHILD_ARRAY

Puntatore a una matrice di strutture PIDL, ognuna delle quali è un elemento da selezionare nella cartella di destinazione a cui fa riferimento pidlFolder.

dwFlags

Tipo: DWORD

Flag facoltativi. In Windows XP questo parametro viene ignorato. In Windows Vista vengono definiti i flag seguenti.

OFASI_EDIT (0x0001)

Selezionare un elemento e impostarne il nome in modalità di modifica. Questo flag può essere usato solo quando viene selezionato un singolo elemento. Per le selezioni di più elementi, viene ignorato.

OFASI_OPENDESKTOP (0x0002)

Selezionare l'elemento o gli elementi sul desktop anziché in una finestra di Esplora risorse. Si noti che se il desktop è nascosto dietro le finestre aperte, non verrà reso visibile.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

È necessario chiamare CoInitialize o CoInitializeEx prima di usare SHOpenFolderAndSelectItems. In caso contrario , SHOpenFolderAndSelectItems avrà esito negativo.

Requisiti