Compartir a través de

Método INameSpaceTreeControl::GetNextItem (shobjidl_core.h)

  • Artículo

Recupera el siguiente elemento del árbol según el método solicitado.

Sintaxis

HRESULT GetNextItem(
  [in, optional] IShellItem *psi,
  [in]           NSTCGNI    nstcgi,
  [out]          IShellItem **ppsiNext
);

Parámetros

[in, optional] psi

Tipo: IShellItem*

Elemento shell para el que se va a recuperar el siguiente elemento. Este valor puede ser NULL.

[in] nstcgi

Tipo: NSTCGNI

Tipo del siguiente elemento. Este valor puede ser una de las marcas siguientes:

NSTCGNI_NEXT (0)

Siguiente elemento relacionado del elemento especificado.

NSTCGNI_NEXTVISIBLE (1)

El siguiente elemento visible del árbol que tiene cualquier relación con el elemento especificado. Esto incluye un elemento secundario (si hay uno), el siguiente elemento del mismo nivel o incluso uno de los hermanos del antecesor.

NSTCGNI_PREV (2)

Elemento relacionado anterior del elemento especificado.

NSTCGNI_PREVVISIBLE (3)

Elemento visible anterior que es un elemento relacionado, un elemento descendiente del mismo nivel o un elemento primario.

NSTCGNI_PARENT (4)

Elemento primario del elemento especificado.

NSTCGNI_CHILD (5)

Primer elemento secundario del elemento especificado.

NSTCGNI_FIRSTVISIBLE (6)

Primer elemento visible absoluto del árbol (no relativo al elemento especificado).

NSTCGNI_LASTVISIBLE (7)

Último elemento visible absoluto del árbol (no relativo al elemento especificado).

[out] ppsiNext

Tipo: IShellItem**

Dirección de un puntero al IShellItem que se ajusta a los criterios del siguiente elemento solicitado.

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 no hay ningún elemento siguiente para el tipo seleccionado, esta función devuelve E_FAIL con NULL para el elemento devuelto, ppsiNext.

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)