IWDTFTarget2::GetValue 메서드(wdtf.h)

지정된 특성과 연결된 대상에서 값을 반환합니다.

구문

HRESULT GetValue(
  [in]          BSTR    SDEL,
  [out, retval] VARIANT *pValue
);

매개 변수

[in] SDEL

검색할 특성 값을 지정하는 SDEL 문입니다.

[out, retval] pValue

이 메서드의 결과를 수신하는 변수의 주소입니다. 결과는 자동화 호환 VARIANT일 수 있습니다.

반환 값

이 메서드가 성공하면 S_OK 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

설명

GetValue 메서드가 일반 SDEL 문을 사용하여 검색하는 필드를 지정합니다. 일반적으로 SDEL 문에는 일치를 수행하기 위한 비교 연산자와 값 지정자가 포함될 수 있습니다. 그러나 GetValue 가 제대로 작동하려면 이러한 항목이 필요하지 않습니다.

SDEL 문에 지정된 모든 필드(관계 집합 반복 포함)에 대해 이 메서드는 VT_EMPTY 이외의 VARIANT 값 집합을 수집합니다. 값이 하나만 있으면 VARIANT 가 반환됩니다. 둘 이상의 값이 발견되면 값은 SAFEARRAY를 포함하는 VARIANT로 패키지됩니다. 값을 찾을 수 없는 경우 메서드는 VT_EMPTY 포함하는 VARIANT를 반환합니다.

또한 AND 연산자는 자체의 양쪽에 있는 값의 수집을 허용하지만 OR 에서는 발견된 첫 번째 값만 수집할 수 있습니다(왼쪽부터 시작).

GetValue 사용에 대한 자세한 내용은 간단한 데이터 평가 언어 개요를 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows XP Professional
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	데스크톱
헤더	wdtf.h

참고 항목

IWDTFTarget2