PSGetPropertyKeyFromName 함수(propsys.h)

정식 속성 이름의 속성 키를 가져옵니다.

구문

PSSTDAPI PSGetPropertyKeyFromName(
  [in]  PCWSTR      pszName,
  [out] PROPERTYKEY *ppropkey
);

[in] pszName

형식: PCWSTR

null로 끝나는 유니코드 문자열로 속성 이름에 대한 포인터입니다.

[out] ppropkey

이 함수가 반환되면 요청된 속성 키가 포함됩니다.

형식: HRESULT

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

속성 키는 속성을 고유하게 식별합니다. 예를 들어 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