INameSpaceTreeControl ::GetNextItem, méthode (shobjidl_core.h)

  • Article

Récupère l’élément suivant de l’arborescence selon la méthode demandée.

Syntaxe

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

Paramètres

[in, optional] psi

Type : IShellItem*

Élément shell pour lequel l’élément suivant est récupéré. Cette valeur peut être NULL.

[in] nstcgi

Type : NSTCGNI

Type de l’élément suivant. Cette valeur peut être l’un des indicateurs suivants :

NSTCGNI_NEXT (0)

Frère suivant de l’élément donné.

NSTCGNI_NEXTVISIBLE (1)

Élément visible suivant dans l’arborescence qui a une relation avec l’élément donné. Cela inclut un enfant (s’il y en a un), le frère suivant, ou même l’un des frères de l’ancêtre.

NSTCGNI_PREV (2)

Élément frère précédent de l’élément donné.

NSTCGNI_PREVVISIBLE (3)

Élément visible précédent qui est un élément frère, un élément descendant frère ou un élément parent.

NSTCGNI_PARENT (4)

Élément parent de l’élément donné.

NSTCGNI_CHILD (5)

Premier élément enfant de l’élément donné.

NSTCGNI_FIRSTVISIBLE (6)

Premier élément visible absolu dans l’arborescence (non relatif à l’élément donné).

NSTCGNI_LASTVISIBLE (7)

Dernier élément absolu visible dans l’arborescence (non relatif à l’élément donné).

[out] ppsiNext

Type : IShellItem**

Adresse d’un pointeur vers l’objet IShellItem qui correspond aux critères de l’élément suivant qui a été demandé.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

S’il n’y a pas d’élément suivant pour le type sélectionné, cette fonction retourne E_FAIL avec null pour l’élément retourné, ppsiNext.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)