Compartir a través de

Función SHCreateShellItem (shlobj_core.h)

  • Artículo

Crea un objeto IShellItem .

Nota Se recomienda usar SHCreateItemWithParent o SHCreateItemFromIDList en lugar de esta función.
 

Sintaxis

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

Parámetros

[in, optional] pidlParent

Tipo: PCIDLIST_ABSOLUTE

PiDL al elemento primario. Este valor puede ser NULL.

[in, optional] psfParent

Tipo: IShellFolder*

Puntero al elemento primario IShellFolder. Este valor puede ser NULL.

[in] pidl

Tipo: PCUITEMID_CHILD

Un PIDL al elemento solicitado. Si la información primaria no se incluye en pidlParent o psfParent, debe ser un PIDL absoluto.

[out] ppsi

Tipo: IShellItem**

Cuando este método vuelve, contiene el puntero de interfaz al nuevo IShellItem.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

SHCreateShellItem crea un objeto que representa un elemento de espacio de nombres de Shell. El llamador debe proporcionar información primaria en pidlParent o psfParent; como alternativa, el autor de la llamada puede proporcionar un IDList absoluto en el parámetro pidl .

Hay tres patrones de llamada válidos para esta función:

  1. La carpeta primaria se identifica mediante un idlist absoluto pidlParent. El parámetro pidl apunta a un IDList secundario que identifica el elemento dentro de la carpeta identificada por pidlParent. 
    IShellItem *psi;
SHCreateShellItem(pidlParent, NULL, pidlChild, &psi);
  2. La carpeta primaria se identifica mediante psfParent. El parámetro pidl apunta a un IDList secundario que identifica el elemento dentro de la carpeta identificada por psfParent. 
    IShellItem *psi;
SHCreateShellItem(NULL, psfParent, pidlChild, &psi);
  3. El elemento se identifica mediante un IDList absoluto que se pasa al parámetro pidl . 
    IShellItem *psi;
SHCreateShellItem(NULL, NULL, pidlFull, &psi);

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Library Shell32.lib
Archivo DLL Shell32.dll
Conjunto de API ext-ms-win-shell-shell32-l1-2-2 (introducido en Windows 10, versión 10.0.14393)