IApplicationDocumentLists::GetList 메서드(shobjidl_core.h)

점프 목록의 최근 항목 또는 자주 사용하는 범주에 나열된 대상의 컬렉션을 나타내는 개체를 검색합니다.

구문

HRESULT GetList(
  [in]  APPDOCLISTTYPE listtype,
  [in]  UINT           cItemsDesired,
  [in]  REFIID         riid,
  [out] void           **ppv
);

[in] listtype

형식: APPDOCLISTTYPE

대상 목록을 검색해야 하는 범주를 지정하는 다음 값 중 하나입니다.

0x0. 최근에 액세스한 항목을 나열하는 최근 범주입니다.

0x1. 가장 많은 횟수에 액세스한 항목을 나열하는 자주 사용하는 범주입니다.

[in] cItemsDesired

형식: UINT

listtype에 지정된 목록에서 검색할 항목 수입니다. 전체 목록을 검색하려면 이 매개 변수를 0으로 설정합니다.

[in] riid

형식: REFIID

일반적으로 IID_IObjectArray 또는 IID_IEnumObjects ppv를 통해 검색할 인터페이스의 IID에 대한 참조입니다.

[out] ppv

형식: void**

이 메서드가 반환되면 riid에서 요청된 인터페이스 포인터가 포함됩니다. 일반적으로 목록에서 검색된 항목을 나타내는 IShellItem 또는 IShellLink 개체의 컬렉션을 나타내는 IObjectArray 또는 IEnumObjects입니다.

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

항목은 최근 목록과 빈 도 목록에 모두 표시할 수 있습니다.

사용자가 최근 또는 자주 사용하는 범주에서 항목을 고정하는 경우 점프 목록에서 중복을 방지하기 위해 항목이 더 이상 원래 범주에 표시되지 않습니다. 그러나 항목은 이 메서드에서 계속 반환됩니다.