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

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

통사론

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

매개 변수

[in] riid

형식: REFIID

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

[out] ppv

형식: void**

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

반환 값

형식: HRESULT

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

발언

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

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

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

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

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

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

요구 사항

참고 항목

ICustomDestinationList

ICustomDestinationList::BeginList

작업 표시줄 확장