Funzione SHCreateShellItem (shlobj_core.h)

Articolo
03/05/2024

Crea un oggetto IShellItem .

Nota È consigliabile usare SHCreateItemWithParent o SHCreateItemFromIDList anziché questa funzione.

Sintassi

SHSTDAPI SHCreateShellItem(
  [in, optional] PCIDLIST_ABSOLUTE pidlParent,
  [in, optional] IShellFolder      *psfParent,
  [in]           PCUITEMID_CHILD   pidl,
  [out]          IShellItem        **ppsi
);

Parametri

[in, optional] pidlParent

Tipo: PCIDLIST_ABSOLUTE

PiDL all'elemento padre. Questo valore può essere NULL.

[in, optional] psfParent

Tipo: IShellFolder*

Puntatore a IShellFolder padre. Questo valore può essere NULL.

[in] pidl

Tipo: PCUITEMID_CHILD

PiDL all'elemento richiesto. Se le informazioni padre non sono incluse in pidlParent o psfParent, questo deve essere un PIDL assoluto.

[out] ppsi

Tipo: IShellItem**

Quando questo metodo restituisce, contiene il puntatore dell'interfaccia al nuovo oggetto IShellItem.

Valore restituito

Tipo: HRESULT

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

Commenti

SHCreateShellItem crea un oggetto che rappresenta un elemento dello spazio dei nomi shell. Il chiamante deve fornire informazioni padre in pidlParent o psfParent; in alternativa, il chiamante può fornire un IDList assoluto nel parametro pidl .

Per questa funzione sono disponibili tre modelli di chiamata validi:

La cartella padre è identificata da un idlist assoluto pidlParent. Il parametro pidl punta a un IDList figlio che identifica l'elemento all'interno della cartella identificata da pidlParent.
```
IShellItem *psi;
SHCreateShellItem(pidlParent, NULL, pidlChild, &psi);
```
La cartella padre è identificata da psfParent. Il parametro pidl punta a un IDList figlio che identifica l'elemento all'interno della cartella identificata da psfParent.
```
IShellItem *psi;
SHCreateShellItem(NULL, psfParent, pidlChild, &psi);
```
L'elemento viene identificato da un IDList assoluto passato al parametro pidl .
```
IShellItem *psi;
SHCreateShellItem(NULL, NULL, pidlFull, &psi);
```

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h (include Shlobj.h)
Libreria	Shell32.lib
DLL	Shell32.dll
Set di API	ext-ms-win-shell32-l1-2-2 (introdotta in Windows 10 versione 10.0.14393)

Condividi tramite