SHSetDefaultProperties 함수(shobjidl.h)

셸 항목에 기본 속성 집합을 적용합니다.

구문

SHSTDAPI SHSetDefaultProperties(
  [in, optional] HWND                       hwnd,
  [in]           IShellItem                 *psi,
                 DWORD                      dwFileOpFlags,
  [in, optional] IFileOperationProgressSink *pfops
);

매개 변수

[in, optional] hwnd

형식: HWND

오류 알림을 받는 항목의 부모 창에 대한 핸들입니다. 이 값은 NULL일 수 있습니다.

[in] psi

형식: IShellItem*

항목을 나타내는 IShellItem 개체에 대한 포인터입니다.

dwFileOpFlags

형식:DWORD

작업을 사용자 지정하는 플래그입니다. 플래그 값 은 IFileOperation::SetOperationFlags 를 참조하세요.

[in, optional] pfops

형식: IFileOperationProgressSink*

작업 진행률을 따르는 데 사용되는 IFileOperationProgressSink 개체에 대한 포인터입니다. 자세한 내용은 IFileOperation::Advise 를 참조하세요. 이 값은 NULL일 수 있습니다.

반환 값

형식: HRESULT

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

설명

기본값을 설정하는 속성 목록은 항목의 파일 연결에 대한 ProgID 아래 의 SetDefaultsFor 레지스트리 항목에서 가져옵니다. 목록은 "prop:"로 접두사로 지정되며 기본값(예: "prop:System.Author;System.Document.DateCreated")을 설정하는 속성의 정식 이름을 포함합니다. 이 목록에 사용할 수 있는 속성은 System.Author, System.Document.DateCreated 및 System.Photo.DateTaken입니다. SetDefaultsFor 항목이 ProgID에 없는 경우 이 함수는 SetDefaultsFor 항목의 HKEY_CLASSES_ROOT\* 기본값을 사용합니다.

요구 사항

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