PSRegisterPropertySchema 함수(propsys.h)
스키마 하위 시스템에 속성 설명 스키마 파일이 추가된 것을 알릴 수 있습니다.
구문
PSSTDAPI PSRegisterPropertySchema(
[in] PCWSTR pszPath
);
매개 변수
[in] pszPath
형식: PCWSTR
로컬 컴퓨터의 속성 설명 스키마 (.propdesc) 파일에 대한 전체 파일 경로(유니코드 문자열)에 대한 포인터입니다. 완전히 지정된 전체 경로 또는 와 같은 %PROGRAMFILES%
환경 변수를 포함하는 전체 경로일 수 있습니다.
반환 값
형식: HRESULT
다음 값 중 하나를 반환합니다.
반환 코드 | Description |
---|---|
|
스키마의 모든 속성 설명이 등록되었습니다. |
|
호출 컨텍스트에는 적절한 권한이 없습니다. |
|
스키마에서 하나 이상의 속성 설명을 등록하지 못했습니다. 특정 오류는 애플리케이션 이벤트 로그에 기록됩니다. |
설명
이 함수는 스키마 하위 시스템의 IPropertySystem::RegisterPropertySchema 구현을 위한 래퍼 API입니다. 파일이 컴퓨터에 처음 설치된 경우에만 이 함수를 호출합니다. 일반적으로 설치 애플리케이션은 .propdesc 파일을 설치한 후 이 함수를 호출합니다. 이 함수는 프로그램 파일 아래 애플리케이션의 설치 디렉터리에 저장되어야 합니다. 여러 스키마 파일을 등록하기 위해 IPropertySystem::RegisterPropertySchema 를 여러 차례 호출할 수 있습니다.
속성 스키마 파일을 등록할 때 다른 사용자로 실행되는 프로세스에서 읽을 수 있습니다. 따라서 컴퓨터의 모든 사용자에게 읽기 권한을 부여하는 위치에 스키마 파일을 배치하는 것이 중요합니다. 마찬가지로 이 함수의 pszPath 매개 변수에서 파일의 절대 경로를 사용합니다.
참고 스키마는 컴퓨터에만 적용되며 각 개별 사용자에 대해 등록할 수 없으므로 Windows Vista에서는 사용자 프로필 아래에 파일 경로를 등록할 수 없습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | WINDOWS XP SP2, Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | WINDOWS Server 2003 SP1 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | propsys.h |
라이브러리 | Propsys.lib |
DLL | Propsys.dll(버전 5.0 이상) |
재배포 가능 파일 | WDS(Windows 데스크톱 검색) 3.0 |