Compartir a través de

Función SHCreateShellItemArray (shobjidl_core.h)

  • Artículo

Crea un objeto de matriz de elementos de Shell.

Sintaxis

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 de 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 esta función vuelve, contiene la dirección de un puntero de interfaz IShellItemArray .

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

Requisito Value
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