다음을 통해 공유

SHGetPropertyStoreForWindow 함수(shellapi.h)

  • 아티클

특정 창의 속성 컬렉션을 나타내는 개체를 검색하여 해당 속성을 쿼리하거나 설정할 수 있습니다.

구문

SHSTDAPI SHGetPropertyStoreForWindow(
  [in]  HWND   hwnd,
  [in]  REFIID riid,
  [out] void   **ppv
);

매개 변수

[in] hwnd

형식: HWND

속성을 검색하는 창에 대한 핸들입니다.

[in] riid

형식: REFIID

ppv를 통해 검색할 속성 저장소 개체의 IID에 대한 참조입니다. 일반적으로 IID_IPropertyStore.

[out] ppv

형식: void**

이 함수가 반환되면 는 riid에서 요청된 인터페이스 포인터를 포함합니다. 일반적으로 IPropertyStore입니다.

반환 값

형식: HRESULT

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

설명

애플리케이션은 이 함수를 사용하여 창의 속성 저장소에 액세스할 수 있으므로 System.AppUserModel.ID 속성에서 명시적 애플리케이션 사용자 모델 ID(AppUserModelID)를 설정할 수 있습니다.

창을 닫기 전에 창의 속성을 제거해야 합니다. 이 작업을 수행하지 않으면 해당 속성에서 사용하는 리소스가 시스템에 반환되지 않습니다. 속성은 PROPVARIANT 형식 VT_EMPTY 설정하여 제거됩니다.

ppv를 통해 검색된 개체에서 IPropertyStore::SetValue를 호출하면 속성과 값이 창에 즉시 저장됩니다. 따라서 IPropertyStore::Commit 에 대한 호출이 필요하지 않습니다. 호출된 경우 오류가 발생하지 않지만 아무런 효과가 없습니다.

애플리케이션은 개별 창에서 AppUserModelIDs를 설정하여 애플리케이션의 작업 표시줄 그룹화 및 목록 점프 콘텐츠를 제어합니다. instance 경우 제품군 애플리케이션은 해당 하위 기능마다 다른 작업 표시줄 단추를 제공하고 해당 하위 기능과 관련된 창이 해당 단추 아래에 그룹화되어 있을 수 있습니다. 창 수준 AppUserModelID가 없으면 해당 창은 모두 기본 프로세스에서 함께 그룹화됩니다.

또한 애플리케이션은 이 속성 저장소를 사용하여 시스템에서 해당 상태로 애플리케이션을 반환할 수 있도록 이러한 다시 시작 속성을 설정해야 합니다.

요구 사항

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

추가 정보

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