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。

規格需求