IApplicationDestinations::RemoveDestination 메서드(shobjidl_core.h)

점프 목록의 최근 및 빈번한 범주에서 단일 대상을 제거합니다.

구문

HRESULT RemoveDestination(
  [in] IUnknown *punk
);

[in] punk

형식: IUnknown*

제거할 대상을 나타내는 IShellItem 또는 IShellLink 에 대한 포인터입니다.

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 표준 COM 오류 값을 반환합니다. 펑크가 가리키는 개체가 IShellItem 또는 IShellLink가 아닌 경우 메서드는 E_INVALIDARG 반환합니다.

대상은 최근 및 자주 사용하는 범주 모두에 표시할 수 있습니다. 이 경우 이 메서드는 두 범주에서 대상을 제거합니다.

사용자가 목록에 고정된 항목은 제거되지 않지만 사용량 현황 데이터는 지워집니다.

애플리케이션은 펑크가 가리키는 항목이 현재 목록에 있는지 모르고 RemoveDestination을 호출할 수 있습니다. 항목에 기존 데이터가 없는 경우(이 경우 최근 또는 자주 목록에 없는 경우) 이 메서드는 아무 작업도 수행하지 않고 S_OK 반환합니다.

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