다음을 통해 공유

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

추가 정보

IWDTFTarget2