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

참고

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

CHUNKSTATE 열거형 값이 CHUNK_TEXT 현재 청크에서 텍스트(텍스트 형식 속성)를 검색합니다.

구문

SCODE GetText(
  [in, out] ULONG *pcwcBuffer,
  [out]     WCHAR *awcBuffer
);

매개 변수

[in, out] pcwcBuffer

항목에서 와이드/유니코드 문자 로 된 awcBuffer 배열의 크기입니다. 종료할 때 awcBuffer에 기록된 유니코드 문자 수입니다.

[out] awcBuffer

현재 청크에서 검색된 텍스트입니다. 문자를 사용하여 버퍼를 종료하지 마세요. null로 끝나는 문자열을 사용합니다. null로 끝나는 문자열은 대상 버퍼의 크기를 초과하면 안 됩니다.

반환 값

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

반환 코드	Description
S_OK	작업이 성공적으로 완료되었습니다.
FILTER_E_NO_TEXT	현재 청크에 대한 STAT_CHUNK 구조체의 flags 멤버에 CHUNK_TEXT 값이 없습니다.
FILTER_E_NO_MORE_TEXT	현재 청크의 모든 텍스트가 반환되었습니다. GetText 메서드에 대한 추가 호출은 IFilter::GetChunk 메서드가 성공적으로 호출될 때까지 이 오류를 반환해야 합니다.
FILTER_S_LAST_TEXT	최적화로 텍스트를 반환하는 마지막 호출은 FILTER_S_LAST_TEXT 반환할 수 있으며, 이는 GetText 메서드에 대한 다음 호출이 FILTER_E_NO_MORE_TEXT 반환함을 나타냅니다. 이 최적화는 GetText에 대한 불필요한 호출을 제거하여 시간을 절약할 수 있습니다.

설명

현재 청크가 awcBuffer 배열에 비해 너무 큰 경우 현재 청크의 모든 텍스트를 검색하려면 GetText 메서드를 두 번 이상 호출해야 할 수 있습니다. GetText 메서드에 대한 각 호출은 GetText 메서드에 대한 마지막 호출의 텍스트 바로 뒤에 있는 텍스트를 검색합니다. 한 호출의 마지막 문자는 단어 중간에 있을 수 있으며 다음 호출의 첫 번째 문자는 해당 단어를 계속합니다. 검색 엔진은 이 상황을 처리해야 합니다.

요구 사항

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

추가 정보

CHUNKSTATE

IFilter