IFileSaveDialog::ApplyProperties 메서드(shobjidl_core.h)

셸의 복사 엔진을 사용하여 항목에 속성 집합을 적용합니다.

구문

HRESULT ApplyProperties(
  [in] IShellItem                 *psi,
  [in] IPropertyStore             *pStore,
  [in] HWND                       hwnd,
  [in] IFileOperationProgressSink *pSink
);

매개 변수

[in] psi

형식: IShellItem*

저장되는 파일을 나타내는 IShellItem 에 대한 포인터입니다. 일반적으로 GetResult에서 검색하는 항목입니다.

[in] pStore

형식: IPropertyStore*

파일에 적용할 속성 값을 나타내는 IPropertyStore 에 대한 포인터입니다. IFileSaveDialog::GetProperties에서 반환된 속성 저장소일 수 있습니다.

[in] hwnd

형식: HWND

애플리케이션 창의 핸들입니다.

[in] pSink

형식: IFileOperationProgressSink*

호출 애플리케이션이 속성 스탬핑의 진행률을 알리려는 경우 사용할 수 있는 선택적 IFileOperationProgressSink 에 대한 포인터입니다. 이 값은 NULL일 수 있습니다.

반환 값

형식: HRESULT

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

설명

이 메서드는 애플리케이션이 속성 컬렉션(IFileSaveDialog::SetCollectedProperties)을 설정했지만 속성 자체를 저장된 파일에 유지하지 않는 경우에 사용해야 합니다.

참고psi 에 지정된 항목으로 표시되는 파일은 IFileSaveDialog::ApplyProperties를 호출하기 전에 실제 스토리지에 있어야 하므로 이전에 저장되었어야 합니다.

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h