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

아티클
08/26/2023

자주 또는 최근 범주를 사용자 지정 점프 목록에 포함되도록 지정합니다.

구문

HRESULT AppendKnownCategory(
  [in] KNOWNDESTCATEGORY category
);

매개 변수

[in] category

형식: KNOWNDESTCATEGORY

목록에 추가할 알려진 범주를 나타내는 다음 값 중 하나입니다.

KDC_FREQUENT (1)

0x1. 자주 하는 범주를 추가 합니다 .

KDC_RECENT (2)

0x2. 최근 범주를 추가합니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다.

개인 정보 그룹 정책 또는 사용자 개인 정보 설정이 있는 경우 이 방법의 결과에 영향을 줄 수 있습니다. 개별 사용에 따라 사용자별 항목이 포함된 범주는 해당 개인 정보 설정에서 허용되지 않습니다. 이로 인해 이 메서드를 통해 추가 된 최근 또는 빈번한 범주에는 데이터가 없으며 데이터가 없는 범주는 표시되지 않습니다. 그러나 이 경우 이 메서드 호출로 인해 오류 코드가 발생하지 않습니다.

설명

이 메서드를 호출하기 전에 ICustomDestinationList::BeginList 를 호출해야 합니다.

최근 범주는 기본 점프 목록에 표시되지만 사용자 지정 점프 목록에 사용자 지정 범주와 함께 표시하려면 이 메서드를 통해 명시적으로 요청해야 합니다.

AppendCategory 및 AppendKnownCategory를 모두 사용하면 둘 이상의 범주에 항목이 표시되지 않도록 사용자 지정 점프 목록을 디자인해야 합니다. 두 범주가 동일한 데이터에 대해 단순히 다른 보기인 경우 사용자의 편의에 기여하지 않고 점프 목록 공간을 사용하므로 해당 범주 중 하나를 제거해야 합니다. 고정된 대상의 경우를 제외하고 시스템에서 중복 항목을 숨기지 않습니다. 이 경우 대상은 고정된 범주에 표시되고 다른 모든 항목에는 숨겨집니다.

자주 사용하는 범주와 최근 범주에는 겹치는 정도가 포함될 수 있으므로 두 범주를 모두 단일 점프 목록에 추가하면 안 됩니다. 둘 중 애플리케이션에 가장 적합한 것은 해당 특성에 따라 달라집니다. Microsoft Word 또는 Microsoft 그림판 같은 파일을 생성하는 애플리케이션은 사용자가 최근에 작업한 파일로 돌아가려고 할 가능성이 가장 높기 때문에 최근 범주를 사용해야 합니다. 다른 곳에서 만든 데이터의 검색 또는 재생에 더 많이 사용되는 애플리케이션은 사용자가 더 많은 수의 항목에 액세스할 가능성이 높기 때문에 자주 사용하는 범주를 사용해야 합니다. 그 중 상당수는 한 번만입니다. 즉, 애플리케이션이 각각 몇 번만 많은 수의 항목에 액세스할 가능성이 가장 높은 경우 사용자가 여러 번 액세스하려는 더 작은 항목 집합에 노이 즈를 발생시키는 것이 가장 좋은 선택입니다. 대부분의 경우 애플리케이션이 더 적은 수의 최신 항목에 액세스할 가능성이 더 높은 경우 최근 항목을 선택해야 합니다.

알려진 최근 또는 자주 사용하는 범주를 포함하여 사용자 지정 점프 목록의 범주는 추가 순서대로 표시되며 목록 맨 아래에 가장 최근에 추가된 범주가 표시됩니다.

ICustomDestinationList::BeginList의 pcMinItems 매개 변수가 가리키는 값 위에 추가된 대상 수는 표시되지 않습니다.

빈 범주가 표시되지 않습니다.

자주 및 최근 범주의 내용은 SHAddToRecentDocs를 직접 사용하는 각 애플리케이션에 대해 계산됩니다. Windows Explorer 통해 파일을 열거나 공통 파일 대화 상자를 사용하여 파일을 열거나 저장하거나 만드는 등의 사용자 작업의 경우 Shell은 애플리케이션을 대신하여 SHAddToRecentDocs를 호출하며 이러한 호출도 사용 통계에서 고려됩니다. 또한 셸은 점프 목록에서 대상이 시작될 때 애플리케이션을 대신하여 SHAddToRecentDocs 를 호출합니다. 그러나 셸이 호출될 것으로 예상되는 경우에도 애플리케이션에서 SHAddToRecentDocs 자체를 명시적으로 호출하는 것이 좋습니다. 이렇게 하면 사용량이 기록되고 최근 또는 빈번한 사용량을 추적하는 알고리즘이 중복 호출에 대해 수정됩니다.

요구 사항

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