IFilter::GetChunk 메서드(filter.h)
참고
인덱싱 서비스는 Windows XP를 기준으로 더 이상 지원되지 않으며 Windows 8을 기준으로 사용할 수 없습니다. 대신 클라이언트 쪽 검색에 Windows Search 를 사용하고 서버 쪽 검색에 Microsoft Search Server Express 를 사용합니다.
GetChunk 메서드에 대한 첫 번째 호출인 경우 필터를 다음 청크의 시작 부분에 배치하거나 첫 번째 청크에 배치하고 현재 청크에 대한 설명을 반환합니다.
구문
SCODE GetChunk(
[out] STAT_CHUNK *pStat
);
매개 변수
[out] pStat
현재 청크에 대한 설명을 포함하는 STAT_CHUNK 구조체에 대한 포인터입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
작업이 성공적으로 완료되었습니다. |
|
이전 청크는 마지막 청크입니다. |
|
다음 청크는 포함이며 콘텐츠 필터를 사용할 수 없습니다. |
|
다음 청크는 링크이며 콘텐츠 필터를 사용할 수 없습니다. |
|
암호 또는 기타 보안 관련 액세스 실패. |
|
일반 액세스 실패. |
설명
반환 시 pStat가 breakType 멤버가 CHUNK_NO_BREAK 동일한 STAT_CHUNK 구조를 가리키는 경우 idChunk 멤버만 새 ID(청크 식별자) 값으로 업데이트됩니다. STAT_CHUNK 구조체의 다른 멤버는 변경되지 않은 상태로 유지됩니다.
내부 값 형식 속성( CHUNKSTATE 열거형 값이 CHUNK_VALUE 청크)은 CHUNK_NO_BREAK 사용하여 연결할 수 없습니다. 한 단어는 두 개 이상의 접착된 청크에 걸쳐 있습니다.
청크 ID 0이 잘못되었습니다.
GetChunk 메서드가 처음으로 호출되기 전에는 현재 청크가 없습니다. 오류 발생 후 getChunk 메서드에 대한 다음 호출을 FILTER_E_END_OF_CHUNKS 이외의 다른 항목의 코드를 반환합니다. 그럼에도 불구하고 사용할 수 없는 청크 다음에 다음 청크를 검색합니다.
발신자에 대한 참고 사항
GetChunk 메서드가 완료되면 *pStat에 설명된 청크가 현재 청크입니다. 청크 설명자는 GetChunk 메서드를 호출하는 루틴에서 소유하지만 속성 사양에서 설정할 수 있는 속성 이름 포인터는 GetChunk 메서드가 소유하며 해제해서는 안 됩니다.구현자에 대한 참고 사항
연결된 개체 또는 포함된 개체의 콘텐츠 필터에 대한 GetChunk 메서드 호출이 FILTER_E_END_OF_CHUNKS 반환하는 경우 구현은 연결 또는 포함 개체의 다음 청크를 반환해야 합니다. 예를 들어 문서에 포함된 개체가 두 개 있고 첫 번째 개체가 FILTER_E_END_OF_CHUNKS 반환된 경우 외부 콘텐츠 필터는 포함된 개체에 대한 콘텐츠 필터의 GetChunk 메서드를 호출해야 합니다.포함된 개체 또는 연결된 개체에서 GetChunk 메서드를 호출한 결과를 반환하기 전에 청크 ID가 고유하도록 검사. 그렇지 않은 경우 구현자는 청크를 다시 실행하고 새 청크 ID의 매핑을 유지해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | filter.h |