Función SHCreateShellItemArray (shobjidl_core.h)

Crea un objeto de matriz de elementos de Shell.

Syntax

SHSTDAPI SHCreateShellItemArray(
  [in]  PCIDLIST_ABSOLUTE     pidlParent,
  [in]  IShellFolder          *psf,
  [in]  UINT                  cidl,
  [in]  PCUITEMID_CHILD_ARRAY ppidl,
  [out] IShellItemArray       **ppsiItemArray
);

Parámetros

[in] pidlParent

Tipo: PCIDLIST_ABSOLUTE

Lista de identificadores de la carpeta primaria de los elementos especificados en ppidl. Si se especifica psf , este parámetro puede ser NULL. Si no se especifica este pidlParent , se calcula desde el parámetro psf mediante IPersistFolder2.

[in] psf

Tipo: IShellFolder*

Objeto de origen de datos shell que es el elemento primario de los elementos secundarios especificados en ppidl. Si se especifica pidlParent , este parámetro puede ser NULL.

[in] cidl

Tipo: UINT

Número de elementos de la matriz especificada por ppidl.

[in] ppidl

Tipo: PCUITEMID_CHILD_ARRAY

Lista de identificadores de elementos secundarios para los que se va a crear la matriz. Este valor puede ser null.

[out] ppsiItemArray

Tipo: IShellItemArray**

Cuando se devuelve esta función, contiene la dirección de un puntero de interfaz IShellItemArray .

Valor devuelto

Tipo: HRESULT

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

Requisitos

Requirement	Importancia
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo admitido	Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
Header	shobjidl_core.h (incluya Shobjidl.h)
Library	OneCore.Lib
DLL	Shell32.dll