다음을 통해 공유

ICustomDestinationList::D eleteList 메서드(shobjidl_core.h)

  • 아티클

지정된 애플리케이션에 대한 사용자 지정 점프 목록을 삭제합니다.

구문

HRESULT DeleteList(
  [in] LPCWSTR pszAppID
);

매개 변수

[in] pszAppID

형식: LPCWSTR

작업 표시줄 단추 표현이 사용자 지정 점프 목록을 표시하는 프로세스의 AppUserModelID에 대한 포인터입니다. Windows 7의 베타 릴리스에서 이 메서드는 별도의 프로세스에서 실행되는 제거기에서 호출되기 때문에 이 AppUserModelID를 명시적으로 제공해야 합니다. 별도의 프로세스에 있으므로 시스템에서 AppUserModelID를 안정적으로 추론할 수 없습니다. 이 제한은 이후 릴리스에서 제거될 것으로 예상됩니다.

반환 값

형식: HRESULT

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

설명

다음을 포함하여 이 메서드를 호출해야 하는 여러 인스턴스가 있습니다.

  • 애플리케이션이 제거된 경우.
  • 사용자가 애플리케이션 내에서 기록을 지울 때
  • 사용자가 애플리케이션의 설정 또는 옵션 페이지에서 대상 추적을 사용하지 않도록 설정하는 경우
애플리케이션이 사용자 지정 대상 목록을 업데이트하는 경우 이 메서드를 호출하면 안 됩니다. 제거 작업 중에 목록을 완전히 지우거나 애플리케이션에서 사용자가 목록을 해제할 수 있는 옵션을 제공하는 경우에만 사용됩니다.

사용자 지정 점프 목록이 제거된 후 최근에 사용한 항목에 대해 시스템 생성 데이터에서 생성된 표준 점프 목록이 표시됩니다. 이러한 데이터가 수집되지 않거나 RemoveAllDestinations를 통해 정보가 지워진 경우 점프 목록에는 고정 또는 고정 해제, 애플리케이션의 새 instance 시작 또는 창을 닫는 표준 작업과 같은 최소, 항상 표시되는 콘텐츠만 포함될 수 있습니다.

요구 사항

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

추가 정보

애플리케이션 사용자 모델 ID(AppUserModelID)

ICustomDestinationList

ICustomDestinationList::SetAppID

작업 표시줄 확장