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

추가 정보

IPropertySystem