IApplicationDestinations 인터페이스(shobjidl_core.h)

애플리케이션이 점프 목록의 최근 또는 빈번한 범주에서 하나 또는 모든 대상을 제거할 수 있도록 하는 메서드를 노출합니다.

상속

IApplicationDestinations 인터페이스는IUnknown 인터페이스에서 상속됩니다. IApplicationDestinations 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IApplicationDestinations 인터페이스에는 이러한 메서드가 있습니다.

IApplicationDestinations::RemoveAllDestinations 애플리케이션의 점프 목록의 최근 및 빈번한 범주에서 모든 대상 항목을 지웁니다.
IApplicationDestinations::RemoveDestination 점프 목록의 최근 및 빈번한 범주에서 단일 대상을 제거합니다.
IApplicationDestinations::SetAppID 이 인터페이스의 메서드가 대상을 제거하는 작업 표시줄 단추의 점프 목록에서 애플리케이션에 대한 고유한 애플리케이션 사용자 모델 ID(AppUserModelID)를 지정합니다. 이 메서드는 선택 사항입니다.

설명

구현 시기

이 인터페이스의 구현은 CLSID_ApplicationDestinations Windows에서 제공됩니다. 이 인터페이스는 타사에서 구현하지 않습니다.

사용 시기

애플리케이션은 점프 목록의 자동으로 생성된 대상에서 항목을 제거하려는 경우 이 인터페이스의 메서드를 호출합니다. 최근 또는 빈번한 범주에 있는 이러한 대상은 명시적으로 또는 Windows Explorer 통해 파일을 열거나 일반적인 파일 대화 상자를 사용하여 파일을 열거나 저장하거나 만들 때 시스템에서 SHAddToRecentDocs에 대한 호출을 통해 생성됩니다.

애플리케이션은 다음과 같은 상황에서 IApplicationDestinations 메서드를 호출해야 합니다.

• 애플리케이션이 제거된 경우.
• 사용자가 기록을 지울 때.
• 사용자가 애플리케이션의 설정 또는 옵션 페이지에서 대상 추적을 사용하지 않도록 설정하는 경우
• 사용자가 애플리케이션 내에서 대상을 삭제하는 경우 파일이 아닌 대상의 경우 특히 중요합니다. 파일이 아닌 대상(일반적으로 항상 IShellLink 항목은 아님)의 경우 더 이상 존재하지 않는다는 것을 감지할 때 목록에서 대상을 제거하는 것은 애플리케이션의 책임입니다.

사용자가 애플리케이션의 개인 정보 설정에서 사용량 추적을 해제하는 경우 애플리케이션은 기존 데이터를 지우고 나중에 해당 항목에 대한 사용량 현황 데이터 수집을 중지해야 합니다. 이 작업은 애플리케이션의 모든 파일 형식 등록에서 NoRecentDocs 값을 설정하여 수행됩니다. 자세한 내용은 FTA_NoRecentDocs 참조하세요.

IApplicationDestinations 메서드는 자동으로 생성된 최근 또는 빈번한 범주에서만 사용됩니다. 사용자가 점프 목록에 고정한 항목은 제거하지 않습니다. 이러한 항목은 프로그래밍 방식으로 제거할 수 없습니다. 사용자만 제거할 수 있습니다. 이러한 메서드는 사용자 지정 범주 또는 작업 목록에도 영향을 주지 않습니다.

요구 사항

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

추가 정보

작업 표시줄 확장