다음을 통해 공유

IFilter::GetValue 메서드(filter.h)

  • 아티클

참고

인덱싱 서비스는 Windows XP를 기준으로 더 이상 지원되지 않으며 Windows 8을 기준으로 사용할 수 없습니다. 대신 클라이언트 쪽 검색에 Windows Search 를 사용하고 서버 쪽 검색에 Microsoft Search Server Express 를 사용합니다.

청크에서 값(내부 값 형식 속성)을 검색합니다. 청크에는 CHUNK_VALUE CHUNKSTATE 열거형 값이 있어야 합니다.

구문

SCODE GetValue(
  [out] PROPVARIANT **ppPropValue
);

매개 변수

[out] ppPropValue

value-type 속성을 포함하는 PROPVARIANT 구조체에 대한 포인터를 수신하는 출력 변수에 대한 포인터입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
 작업이 성공적으로 완료되었습니다.
FILTER_E_NO_MORE_VALUES
GetValue 메서드는 이 청크에서 이미 호출되었습니다. 이 값은 IFilter::GetChunk 메서드가 성공적으로 호출되고 다음 청크로 고급화될 때까지 반환되어야 합니다.
FILTER_E_NO_VALUES
 현재 청크에는 CHUNK_VALUE CHUNKSTATE 열거형 값이 없습니다.

설명

GetValue 메서드는 청크당 한 번만 호출합니다.

둘 이상의 청크에서 동일한 값을 생성하는 효과는 정의되지 않습니다. 값의 마지막 설정만 유효합니다.

발신자에게 참고 사항

CoTaskMemAlloc를 사용하여 PROPVARIANT 구조를 할당합니다. 일부 PROPVARIANT 구조체에는 PropVariantClear 함수를 호출하여 해제할 수 있는 포인터가 포함되어 있습니다. PropVariantClear를 호출하는 것은 GetValue 메서드의 호출자에게 달려 있습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 filter.h

추가 정보

IFilter