PSStringFromPropertyKey 함수(propsys.h)

해당 속성의 키에서 속성을 식별하는 문자열을 만듭니다.

구문

PSSTDAPI PSStringFromPropertyKey(
  [in]  REFPROPERTYKEY pkey,
  [out] LPWSTR         psz,
  [in]  UINT           cch
);

매개 변수

[in] pkey

형식: REFPROPERTYKEY

속성을 식별하는 PROPERTYKEY 구조체에 대한 참조입니다.

[out] psz

형식: LPWSTR

출력 문자열을 수신하는 버퍼에 대한 포인터입니다. 버퍼는 PKEYSTR_MAX WCHAR를 포함할 수 있을 만큼 커야 합니다.

[in] cch

형식: UINT

WCHAR에서 psz가 가리키는 버퍼의 길이입니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

검색된 문자열 형식은 입니다 "{propkey.fmtid} propkey.pid". 예를 들어 의 출력 문자열 PKEY_Title 은 입니다 "{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2".

예제

더 큰 프로그램의 일부로 포함할 다음 예제에서는 PSPropertyKeyFromString을 사용하는 방법을 보여 줍니다.

WCHAR szKey[PKEYSTR_MAX]

HRESULT hr = PSStringFromPropertyKey(PKEY_Title, szKey, ARRAYSIZE(szKey));

if (SUCCEEDED(hr))
{
    // szKey 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

추가 정보

PSGetNameFromPropertyKey

PSPropertyKeyFromString