ICustomDestinationList::BeginList 메서드(shobjidl_core.h)

사용자 지정 점프 목록에 대한 빌드 세션을 시작합니다.

구문

HRESULT BeginList(
  [out] UINT   *pcMinSlots,
  [in]  REFIID riid,
  [out] void   **ppv
);

매개 변수

[out] pcMinSlots

형식: UINT*

이 메서드가 반환되면 작업 표시줄 및 시작 메뉴 속성 창의 점프 Lists 옵션에 표시할 최근 항목 수에 대한 현재 사용자 설정을 가리키는 포인터입니다. 기본값은 10입니다. 표시될 최대 대상 수이며 범주에 관계없이 모든 대상의 총 개수입니다. 더 많은 대상을 추가할 수 있지만 UI에는 표시되지 않습니다.

점프 목록에는 항상 적어도 많은 슬롯(대상 및 공간이 있는 경우 작업)이 표시됩니다.

구분 기호와 머리글의 총 수가 4개를 초과하지 않는 한 이 숫자에는 구분 기호와 구역 머리글이 포함되지 않습니다. 처음 4개를 초과하는 구분 기호 및 섹션 헤더는 공간이 제한된 경우 표시되는 대상 수를 줄일 수 있습니다. 이 숫자는 고정 또는 고정 해제, 창 닫기 또는 새 instance 시작하기 위한 표준 명령 항목에는 영향을 주지 않습니다. 또한 작업 또는 고정된 항목에는 영향을 주지 않으며 표시할 수 있는 수는 점프 목록에 사용할 수 있는 공간을 기반으로 합니다.

[in] riid

형식: REFIID

일반적으로 IID_IObjectArray ppv에서 검색할 인터페이스의 IID에 대한 참조로, 애플리케이션에 대해 제거된 대상 목록에 현재 저장된 모든 항목을 나타냅니다. 이 정보는 제거된 항목이 새 점프 목록의 일부가 아닌지 확인하는 데 사용됩니다.

[out] ppv

형식: void**

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

반환 값

형식: HRESULT

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

설명

애플리케이션에 명시적 애플리케이션 사용자 모델 ID(AppUserModelID)가 있는 경우 이 메서드를 호출하기 전에 ICustomDestinationList::SetAppID 를 호출해야 합니다.

ppv 매개 변수에서 검색된 IObjectArray 인터페이스는 GetRemovedDestinations를 통해 검색되는 제거된 대상의 동일한 목록을 나타냅니다. 새 점프 목록이 생성되는 경우 애플리케이션은 먼저 제거된 대상을 처리해야 합니다. 제거된 목록의 모든 항목에 대한 추적 데이터를 지워야 합니다. 애플리케이션이 이 제거된 대상 목록에 있는 AppendCategory 를 통해 항목을 포함하려고 하면 AppendCategory 호출이 실패합니다. 이렇게 하면 애플리케이션이 사용자가 선택한 제거된 항목을 준수할 수 있습니다. BeginList 이후 제거된 항목을 다시 추가하려고 시도하여 AppendCategory를 호출하지 않고 CommitList를 호출하면 제거된 대상 목록이 지워집니다. 그 후 사용자가 항목을 계속 사용하는 경우 이전에 제거된 항목이 대상 목록으로 돌아갈 수 있습니다.

AppendCategory, AppendKnownCategory 또는 AddUserTasks를 통해 목록을 채우기 위해 호출하기 전에 목록을 시작하려면 BeginList를 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 6.1 이상)

추가 정보

ICustomDestinationList

작업 표시줄 확장