IPropertySystem::RegisterPropertySchema 메서드(propsys.h)

  • 아티클

속성 설명 스키마 파일이 추가된 것을 스키마 하위 시스템에 알릴 수 있습니다.

구문

HRESULT RegisterPropertySchema(
  [in] LPCWSTR pszPath
);

매개 변수

[in] pszPath

형식: LPCWSTR

로컬 컴퓨터에서 .propdesc 파일의 파일 경로에 대한 포인터입니다.

반환 값

형식: HRESULT

다음 값 중 하나를 반환합니다.

반환 코드 Description
S_OK
 스키마가 등록되었음을 나타냅니다.
E_ACCESSDENIED
 호출 컨텍스트에 적절한 권한이 없음을 나타냅니다.
INPLACE_S_TRUNCATED
 스키마의 속성 설명 중 하나 이상이 등록되지 않음을 나타냅니다.

설명

이 메서드는 로컬 컴퓨터의 .propdesc 파일에 대한 파일 경로를 사용하여 속성 설명 스키마(.propdesc) 파일을 추가하는 것을 스키마 하위 시스템에 알릴 수 있습니다. 파일이 컴퓨터에 처음 설치된 경우에만 이 메서드를 호출합니다. 일반적으로 설치 애플리케이션은 .propdesc 파일을 설치한 후 이 메서드를 호출합니다. 이 파일은 "프로그램 파일"에서 애플리케이션의 설치 디렉터리에 저장되어야 합니다. 여러 스키마 파일을 일괄 등록하기 위해 IPropertySystem::RegisterPropertySchema 를 여러 번 호출할 수 있습니다.

속성 설명이 로드되지 않도록 하는 오류가 발생하면 원인이 애플리케이션 이벤트 로그에 기록됩니다. 호출 컨텍스트에 HKLM(HKEY_LOCAL_MACHINE)에 대한 쓰기 액세스를 포함하는 적절한 권한이 없는 경우 이 메서드는 E_ACCESSDENIED 실패합니다. LUA(제한된 사용자 계정) 메커니즘을 통해 권한을 얻는 것은 호출 애플리케이션의 책임입니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 WINDOWS XP SP2, Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 SP1 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 propsys.h
DLL Propsys.dll(버전 5.0 이상)
재배포 가능 파일 WDS(Windows 데스크톱 검색) 3.0

추가 정보

IPropertySystem