IWDTFTarget2::GetValue 메서드(wdtf.h)
지정된 특성과 연결된 대상의 값을 반환합니다.
구문
HRESULT GetValue(
[in] BSTR SDEL,
[out, retval] VARIANT *pValue
);
매개 변수
[in] SDEL
검색할 특성 값을 지정하는 SDEL 문입니다.
[out, retval] pValue
이 메서드의 결과를 받는 변수의 주소입니다. 결과는 자동화 호환 VARIANT일 수 있습니다.
반환 값
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
일반 SDEL 문을 사용하여 GetValue 메서드가 검색하는 필드를 지정합니다. 일반적으로 SDEL 문에는 일치를 수행할 비교 연산자 및 값 지정자가 포함될 수 있습니다. 그러나 GetValue 가 제대로 작동하려면 이러한 항목이 필요하지 않습니다.
SDEL 문에 지정된 모든 필드(관계 집합 반복 포함)에 대해 이 메서드는 (VT_EMPTY 아닌) VARIANT 값 집합을 수집합니다. 값이 하나만 있으면 해당 VARIANT 가 반환됩니다. 둘 이상의 값이 발견되면 값은 SAFEARRAY를 포함하는 VARIANT로 패키지됩니다. 값을 찾을 수 없으면 메서드는 VT_EMPTY 포함하는 VARIANT를 반환합니다.
또한 AND 연산자는 자체의 양쪽에 있는 값의 수집을 허용하지만 OR 은 찾은 첫 번째 값(왼쪽부터 시작)의 컬렉션만 허용합니다.
GetValue 사용에 대한 자세한 내용은 단순 데이터 평가 언어 개요를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP Professional |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | wdtf.h |