IPropertyStore::GetValue 메서드(propsys.h)

이 메서드는 특정 속성에 대 한 데이터를 검색 합니다.

구문

HRESULT GetValue(
  REFPROPERTYKEY key,
  PROPVARIANT    *pv
);

매개 변수

key

TBD

pv

메서드가 IPropertyStore::GetValue 성공적으로 반환되면 이 매개 변수는 속성에 대한 데이터가 포함된 PROPVARIANT 구조를 가리킵니다.

반환 값

성공하면 S_OK 반환하거나 INPLACE_S_TRUNCATED 반환하거나, 그렇지 않으면 오류 값을 반환합니다.

반환된 PROPVARIANT가 보다 정식 형식으로 변환되었음을 나타내기 위해 INPLACE_S_TRUNCATED 반환됩니다. 예를 들어 문자열 값에서 선행 또는 후행 공백을 자르기 위해 이 작업을 수행합니다. 성공 매크로를 사용하여 INPLACE_S_TRUNCATED 성공 코드로 처리하는 반환 값을 검사 합니다. SUCCEEDED 매크로는 Winerror.h 파일에 정의되어 있습니다.

설명

키에서 참조되는 PROPERTYKEY가 속성 저장소에 없으면 이 메서드는 S_OK 반환하고 pv에서 가리키는 구조체의 vt 멤버는 VT_EMPTY 설정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	propsys.h
라이브러리	Propsys.idl
IRQL	모든 수준

추가 정보

IPropertyStore

IPropertyStore::GetAt