INameSpaceTreeControl::GetNextItem-Methode (shobjidl_core.h)

Artikel
03/02/2024

Ruft das nächste Element in der Struktur gemäß der angeforderten Methode ab.

Syntax

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

Parameter

[in, optional] psi

Typ: IShellItem*

Das Shellelement, für das das nächste Element abgerufen wird. Dieser Wert kann NULL sein.

[in] nstcgi

Typ: NSTCGNI

Der Typ des nächsten Elements. Dieser Wert kann eines der folgenden Flags sein:

NSTCGNI_NEXT (0)

Das nächste gleichgeordnete Element des angegebenen Elements.

NSTCGNI_NEXTVISIBLE (1)

Das nächste sichtbare Element in der Struktur, das eine beliebige Beziehung zum angegebenen Element aufweist. Dies schließt ein Kind (falls vorhanden), das nächste Geschwisterkind oder sogar eines der Geschwister des Vorgängers ein.

NSTCGNI_PREV (2)

Das vorherige gleichgeordnete Element des angegebenen Elements.

NSTCGNI_PREVVISIBLE (3)

Das vorherige sichtbare Element, das ein gleichgeordnetes Element, ein untergeordnetes element oder ein übergeordnetes Element ist.

NSTCGNI_PARENT (4)

Das übergeordnete Element des angegebenen Elements.

NSTCGNI_CHILD (5)

Das erste untergeordnete Element des angegebenen Elements.

NSTCGNI_FIRSTVISIBLE (6)

Das absolute erste sichtbare Element in der Struktur (nicht relativ zum angegebenen Element).

NSTCGNI_LASTVISIBLE (7)

Das absolute letzte sichtbare Element in der Struktur (nicht relativ zum angegebenen Element).

[out] ppsiNext

Typ: IShellItem**

Die Adresse eines Zeigers auf das IShellItem , das den Kriterien für das nächste angeforderte Element entspricht.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn kein nächstes Element für den ausgewählten Typ vorhanden ist, gibt diese Funktion E_FAIL mit NULL für das zurückgegebene Element ppsiNext zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Share via