INameSpaceTreeControl：：GetNextItem 方法 (shobjidl_core.h)

發行項
03/02/2024

根據所要求的方法，擷取樹狀結構中的下一個專案。

語法

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

參數

[in, optional] psi

類型： IShellItem*

正在擷取下一個專案的Shell專案。此值可以是 NULL。

[in] nstcgi

類型： NSTCGNI

下一個項目的類型。此值可以是下列其中一個旗標：

NSTCGNI_NEXT (0)

指定專案的下一個同層級。

NSTCGNI_NEXTVISIBLE (1)

樹狀結構中具有任何關聯性之樹狀結構中的下一個可見專案。這包括子系 (，如果有一個) 、下一個同層級，或甚至是其中一個上階的同層級。

NSTCGNI_PREV (2)

指定專案的上一個同層級專案。

NSTCGNI_PREVVISIBLE (3)

上一個可見專案，其為同層級專案、同層級子專案或父專案。

NSTCGNI_PARENT (4)

指定專案的父專案。

NSTCGNI_CHILD (5)

指定專案的第一個子專案。

NSTCGNI_FIRSTVISIBLE (6)

樹狀結構中的絕對第一個可見專案 (相對於指定專案) 。

NSTCGNI_LASTVISIBLE (7)

樹狀結構中的絕對最後一個可見專案 (相對於指定專案) 。

[out] ppsiNext

類型： IShellItem**

IShellItem 指標的位址，其符合所要求下一個專案的準則。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

備註

如果選取的型別沒有下一個專案，此函式 會針對傳 回的專案 ppsiNext 傳回 null 傳回E_FAIL。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包含 Shobjidl.h)

共用方式為