PSRegisterPropertySchema 함수(propsys.h)

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

구문

PSSTDAPI PSRegisterPropertySchema(
  [in] PCWSTR pszPath
);

매개 변수

[in] pszPath

형식: PCWSTR

로컬 컴퓨터의 속성 설명 스키마 (.propdesc) 파일에 대한 전체 파일 경로(유니코드 문자열)에 대한 포인터입니다. 완전히 지정된 전체 경로 또는 와 같은 %PROGRAMFILES%환경 변수를 포함하는 전체 경로일 수 있습니다.

반환 값

형식: HRESULT

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

반환 코드	Description
S_OK	스키마의 모든 속성 설명이 등록되었습니다.
E_ACCESSDENIED	호출 컨텍스트에는 적절한 권한이 없습니다.
INPLACE_S_TRUNCATED	스키마에서 하나 이상의 속성 설명을 등록하지 못했습니다. 특정 오류는 애플리케이션 이벤트 로그에 기록됩니다.

설명

이 함수는 스키마 하위 시스템의 IPropertySystem::RegisterPropertySchema 구현을 위한 래퍼 API입니다. 파일이 컴퓨터에 처음 설치된 경우에만 이 함수를 호출합니다. 일반적으로 설치 애플리케이션은 .propdesc 파일을 설치한 후 이 함수를 호출합니다. 이 함수는 프로그램 파일 아래 애플리케이션의 설치 디렉터리에 저장되어야 합니다. 여러 스키마 파일을 등록하기 위해 IPropertySystem::RegisterPropertySchema 를 여러 차례 호출할 수 있습니다.

속성 스키마 파일을 등록할 때 다른 사용자로 실행되는 프로세스에서 읽을 수 있습니다. 따라서 컴퓨터의 모든 사용자에게 읽기 권한을 부여하는 위치에 스키마 파일을 배치하는 것이 중요합니다. 마찬가지로 이 함수의 pszPath 매개 변수에서 파일의 절대 경로를 사용합니다.

참고 스키마는 컴퓨터에만 적용되며 각 개별 사용자에 대해 등록할 수 없으므로 Windows Vista에서는 사용자 프로필 아래에 파일 경로를 등록할 수 없습니다.

 

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

요구 사항

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