PSGetPropertyKeyFromName 함수(propsys.h)
정식 속성 이름의 속성 키를 가져옵니다.
구문
PSSTDAPI PSGetPropertyKeyFromName(
[in] PCWSTR pszName,
[out] PROPERTYKEY *ppropkey
);
매개 변수
[in] pszName
형식: PCWSTR
null로 끝나는 유니코드 문자열로 속성 이름에 대한 포인터입니다.
[out] ppropkey
형식: PROPERTYKEY*
이 함수가 반환되면 요청된 속성 키가 포함됩니다.
반환 값
형식: HRESULT
다음 값 중 하나를 반환합니다.
| 반환 코드 | Description |
|---|---|
|
속성 키 구조를 얻었습니다. |
|
pszName 매개 변수는 NULL입니다. |
|
정식 속성 이름이 스키마 하위 시스템 캐시에 없습니다. |
설명
속성 키는 속성을 고유하게 식별합니다. 예를 들어 PKEY_Keywords는 System.Keywords에 해당합니다. 이 함수는 속성 스키마의 일부로 등록된 속성에 대해서만 성공합니다.
함수에서도 지원되는 레거시 속성 이름 목록은 PSGetPropertyDescriptionByName 을 참조하세요.
예제
더 큰 프로그램의 일부로 포함할 다음 예제에서는 PSGetPropertyKeyFromName 을 사용하여 에 대한 System.Keywords속성 키를 가져오는 방법을 보여 줍니다.
PROPERTYKEY key;
HRESULT hr = PSGetPropertyKeyFromName(L"System.Keywords", &key);
if (SUCCEEDED(hr))
{
// The property key is now valid.
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | WINDOWS XP SP2, Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 SP1 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | propsys.h |
| 라이브러리 | Propsys.lib |
| DLL | Propsys.dll(버전 6.0 이상) |
| 재배포 가능 파일 | WDS(Windows 데스크톱 검색) 3.0 |