SetCurrentProcessExplicitAppUserModelID 함수(shobjidl_core.h)

  • 아티클

작업 표시줄에 대한 현재 프로세스를 식별하는 고유한 애플리케이션 정의 애플리케이션 사용자 모델 ID(AppUserModelID)를 지정합니다. 이 식별자를 사용하면 애플리케이션이 연결된 프로세스와 창을 단일 작업 표시줄 단추 아래에 그룹화할 수 있습니다.

구문

SHSTDAPI SetCurrentProcessExplicitAppUserModelID(
  [in] PCWSTR AppID
);

매개 변수

[in] AppID

형식: PCWSTR

현재 프로세스에 할당할 AppUserModelID에 대한 포인터입니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

애플리케이션이 UI를 표시하거나 Jump Lists 조작하기 전에 애플리케이션의 초기 시작 루틴 중에 이 메서드를 호출해야 합니다. 여기에는 SHAddToRecentDocs에 대한 모든 호출이 포함됩니다.

요구 사항

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

추가 정보

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

GetCurrentProcessExplicitAppUserModelID

작업 표시줄 확장