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

이 사용자 지정 점프 목록을 대체하려는 기존 점프 목록에서 사용자가 제거한 대상의 현재 목록을 검색합니다.

구문

HRESULT GetRemovedDestinations(
  [in]  REFIID riid,
  [out] void   **ppv
);

매개 변수

[in] riid

형식: REFIID

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

[out] ppv

형식: void**

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

반환 값

형식: HRESULT

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

설명

사용자 작업을 통해 점프 목록 UI에서 항목을 제거할 수 있습니다. 그런 다음 항목이 제거된 것으로 표시되고 더 이상 표시되지 않습니다. 애플리케이션은 사용자 지정 목록에 표시하지 않도록 사용자가 제거한 항목을 알리기 위해 이 메서드를 사용할 수 있습니다. instance 경우 애플리케이션이 시작될 때 ICustomDestinationList::BeginList를 통해 새 목록을 생성하지 않을 경우 이 메서드를 호출해야 합니다.

사용자가 해당 대상을 제거하기로 선택할 때 애플리케이션에서 대상 추적 데이터를 지우는 것이 좋습니다. 사용자가 나중에 해당 대상에 다시 액세스하는 경우 점프 목록에 다시 추가되고 데이터를 다시 누적할 수 있습니다. 이 메서드에서 검색한 동일한 제거된 대상 목록은 ICustomDestinationList::BeginList 가 호출될 때 검색됩니다. 이 경우 애플리케이션은 제거된 항목을 즉시 다시 삽입하려고 시도해서는 안 되며 AppendCategory 에 대한 호출이 실패합니다. 이렇게 하면 애플리케이션이 항목을 제거하려는 사용자의 의도를 준수합니다.

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

애플리케이션이 GetRemovedDestinations 를 호출하고 새 사용자 지정 점프 목록을 만들 것으로 예상되는 것보다 빨리 점프 목록으로 복원할 가능성이 높은 항목을 목록에서 찾더라도 애플리케이션은 해당 항목 없이 점프 목록을 작성하고 사용자가 다시 액세스한 후에만 목록에 다시 추가해야 합니다.

애플리케이션은 사용자 지정 점프 목록에 최근 또는 자주알려진 범주 를 추가할 수 있습니다. 해당 범주의 항목은 사용자 지정 범주에 표시되지 않았더라도 제거된 항목 목록에 있을 수 있습니다. 이 경우 애플리케이션은 저장된 항목이 있는 경우 해당 항목에 대한 사용량 현황 데이터를 지워야 합니다.

GetRemovedDestinations를 호출해도 제거된 대상 데이터가 지워지지 않습니다. 이 데이터는 다음 목록 생성을 위해 BeginList 에 필요합니다. 제거된 대상 데이터는 더 이상 필요하지 않으며 BeginList에서 목록 생성 세션을 시작하고 AppendCategory에 대한 실패한 호출 없이 계속 실행한 후 CommitList 호출로 완료된 후에 지워집니다.

요구 사항

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

추가 정보

ICustomDestinationList

ICustomDestinationList::BeginList

작업 표시줄 확장