IApplicationDocumentLists::SetAppID 메서드(shobjidl_core.h)

대상 목록이 검색되는 애플리케이션에 대한 고유한 애플리케이션 사용자 모델 ID(AppUserModelID)를 지정합니다. 이 메서드는 선택 사항입니다.

구문

HRESULT SetAppID(
  [in] LPCWSTR pszAppID
);

매개 변수

[in] pszAppID

형식: LPCWSTR

작업 표시줄 단추 표현이 점프 목록을 받는 프로세스의 AppUserModelID에 대한 포인터입니다.

반환 값

형식: HRESULT

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

설명

애플리케이션에 명시적 AppUserModelID가 있는 경우 GetList를 호출하기 전에 이 메서드를 호출해야 합니다.

개체의 SetAppID 메서드를 통해 AppUserModelID를 지정한 후 AppUserModelID는 해당 개체의 수명 동안 개체에 저장되므로 SetAppID에 대한 다른 호출로 덮어쓰지 않습니다.

일부 애플리케이션은 명시적 AppUserModelID를 선언하지 않으며 이 메서드를 호출해서는 안 됩니다. 이 경우 IApplicationDocumentLists::GetList 가 호출될 때 애플리케이션의 ID가 추론됩니다. 그러나 이러한 계산을 방지하는 데는 성능 이점이 있으므로 사용자 지정 점프 목록을 제공하는 애플리케이션은 명시적 AppUserModelID를 사용하는 것이 좋습니다.

요구 사항

추가 정보

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

IApplicationDocumentLists

작업 표시줄 확장