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 | 모든 수준 |