IPropertySystem::GetPropertyDescriptionByName 메서드(propsys.h)

지정된 정식 이름에 대한 속성 설명을 얻기 위해 IPropertyDescription을 구현하는 하위 시스템 개체의 instance 가져옵니다.

구문

HRESULT GetPropertyDescriptionByName(
  [in]  LPCWSTR pszCanonicalName,
  [in]  REFIID  riid,
  [out] void    **ppv
);

[in] pszCanonicalName

형식: LPCWSTR

속성을 식별하는 문자열에 대한 포인터입니다.

[in] riid

형식: REFIID

원하는 IID에 대한 참조입니다.

[out] ppv

형식: void**

IPropertyDescription 인터페이스 포인터의 주소입니다.

형식: PSSTDAPI

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

반환 코드	Description
S_OK	인터페이스가 획득되었음을 나타냅니다.
E_INVALIDARG	pszCanonicalName이 NULL임을 나타냅니다.
TYPE_E_ELEMENTNOTFOUND	정식 이름이 스키마 하위 시스템 캐시에 없음을 나타냅니다.

objbase.h에 정의된 IID_PPV_ARGS 매크로를 사용하여 riid 및 ppv 매개 변수를 패키지하는 것이 좋습니다. 이 매크로는 ppv의 값이 가리키는 인터페이스를 기반으로 올바른 IID를 제공하므로 코딩 오류가 발생할 가능성이 없습니다.

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