ILNext 函式 (shlobj_core.h)

擷取ITEMIDLIST結構中的下一個SHITEMID結構。

語法

PCUIDLIST_RELATIVE ILNext(
  [in] PCUIDLIST_RELATIVE pidl
);

參數

[in] pidl

類型: PCUIDLIST_RELATIVE

要擷取下一個 SHITEMID 結構的常數、未對齊的相對 PIDL。

傳回值

類型: PCUIDLIST_RELATIVE

當此函式傳回時,會包含三個結果之一:如果pidl有效且不是ITEMIDLIST中的最後一個SHITEMID,則會包含下一個ITEMIDLIST結構的指標。 如果傳遞最後一 個 ITEMIDLIST 結構,則會包含 Null,以發出 PIDL 結尾的訊號。 對於 pidl的其他值,傳回值是無意義的。

備註

用於定義STRICT_TYPED_ITEMIDS的位置。

若要確認傳回值是否為 Null,請使用 ILIsEmpty

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平臺 Windows
標頭 shlobj_core.h (包含 Shlobj.h)