Compartir a través de

Función SHCreateItemWithParent (shobjidl_core.h)

  • Artículo

Cree un elemento de Shell, dada una carpeta primaria y un identificador de elemento secundario.

Sintaxis

SHSTDAPI SHCreateItemWithParent(
  [in]  PCIDLIST_ABSOLUTE pidlParent,
  [in]  IShellFolder      *psfParent,
  [in]  PCUITEMID_CHILD   pidl,
  [in]  REFIID            riid,
  [out] void              **ppvItem
);

Parámetros

[in] pidlParent

Tipo: PCIDLIST_ABSOLUTE

IdList de la carpeta primaria del elemento que se va a crear; idList de psfParent. Este parámetro puede ser NULL, si se especifica psfParent .

[in] psfParent

Tipo: IShellFolder*

Puntero a la interfaz IShellFolder que especifica el origen de datos del shell del elemento secundario especificado por el pidl. Este parámetro puede ser NULL, si se especifica pidlParent .

[in] pidl

Tipo: PCUITEMID_CHILD

Identificador de elemento secundario relativo a su carpeta primaria especificada por psfParent o pidlParent.

[in] riid

Tipo: REFIID

Referencia a un identificador de interfaz.

[out] ppvItem

Tipo: void**

Cuando se devuelve esta función, contiene el puntero de interfaz solicitado en riid. Normalmente, será IShellItem o IShellItem2.

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.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)
Archivo DLL Shell32.dll