Compartir a través de

Método IShellFolderView::AddObject (shlobj_core.h)

  • Artículo

[AddObject está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Agrega un elemento a la vista.

Sintaxis

HRESULT AddObject(
  [in]  PUITEMID_CHILD pidl,
  [out] UINT           *puItem
);

Parámetros

[in] pidl

Tipo: PUITEMID_CHILD

Puntero a un ItemID que especifica el elemento que se va a agregar a la vista.

[out] puItem

Tipo: UINT*

Puntero a un valor que, cuando este método devuelve correctamente, recibe la posición de índice del elemento agregado.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Si llama inmediatamente a IShellFolderView::GetObject con este índice, obtendrá una copia de la ITEMID_CHILD que agregó. Sin embargo, la posición de índice de un elemento puede cambiar con el tiempo, por lo que el código no puede confiar en que ningún índice específico siempre devuelva la misma ITEMID_CHILD.

Los elementos agregados a través de este método se pueden quitar de la vista por el origen de datos en cualquier momento.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h