SHAddDefaultPropertiesByExt 함수(shobjidl.h)

지정된 파일 확장 프로그램에 대해 등록된 대로 속성 저장소에 기본 속성을 추가합니다.

구문

SHSTDAPI SHAddDefaultPropertiesByExt(
  [in] PCWSTR         pszExt,
  [in] IPropertyStore *pPropStore
);

매개 변수

[in] pszExt

형식: PCWSTR

확장을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in] pPropStore

형식: IPropertyStore*

추가할 기본 속성을 정의하는 IPropertyStore 인터페이스에 대한 포인터입니다.

반환 값

형식: HRESULT

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

설명

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

System.Author 에는 작업을 수행한 사용자의 값이 있습니다. System.Document.DateCreated 및 System.Photo.DateTaken 은 현재 날짜를 사용합니다. 이러한 세 가지 속성은 시스템에서 특별한 기본값을 제공하는 유일한 속성입니다.

다음과 같은 몇 가지 유형의 속성이 있습니다.

1. 파일 시스템에서 파생되는 속성(예: 생성된 크기 및 날짜)
2. 파일에서 파생되는 속성(예: 차원 및 페이지 수)
3. 파일에 배치되는 속성(예: 작성자 및 태그)

새 파일을 만들 때 파일을 만드는 것만으로 1과 2 형식이 제공됩니다. 그러나 형식 3의 속성은 프로그램에서 명시적으로 설정해야 합니다. 시스템은 SHAddDefaultPropertiesByExt 를 제공하여 3형의 최대 3가지 특정 속성에 대한 값을 제공합니다. Windows Explorer 파일을 처음 저장할 때 또는 바로 가기 메뉴에서 새로 만들기를 선택한 후 새 파일을 만들 때 이 API를 사용하는 경우가 있습니다.

요구 사항

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