IFilter::Init 메서드(filter.h)
참고
인덱싱 서비스는 Windows XP에서 더 이상 지원되지 않으며 Windows 8 현재 사용할 수 없습니다. 대신 클라이언트 쪽 검색에 Windows Search 를 사용하고 서버 쪽 검색에 Microsoft Search Server Express 를 사용합니다.
필터링 세션을 초기화합니다.
구문
SCODE Init(
[in] ULONG grfFlags,
[in] ULONG cAttributes,
[in] const FULLPROPSPEC *aAttributes,
[out] ULONG *pFlags
);
매개 변수
[in] grfFlags
텍스트 표준화, 속성 출력, scope 포함 및 IFilter 액세스 패턴을 제어하기 위한 IFILTER_INIT 열거형의 값입니다.
[in] cAttributes
특성 배열의 크기입니다. 0이 아닌 경우 cAttributes 가 grfFlags에 지정된 특성보다 우선합니다. 특성 플래그를 지정하지 않고 cAttributes가 0이면 파일, 크기 등에 대한 마지막 쓰기의 날짜와 시간을 포함하는 PSGUID_STORAGE 스토리지 속성 집합에 의해 기본값이 지정됩니다. 및 는 파일의 기본 내용에 매핑되는 PID_STG_CONTENTS 'contents' 속성에 의해 수행됩니다. 속성 및 속성 집합에 대한 자세한 내용은 속성 집합을 참조하세요.
[in] aAttributes
요청된 속성에 대한 FULLPROPSPEC 구조체의 배열에 대한 포인터입니다. cAttributes가 0이 아닌 경우 aAttributes의 속성만 반환됩니다.
[out] pFlags
호출자가 사용할 수 있는 추가 속성에 대한 정보; IFILTER_FLAGS 열거형에서
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
작업이 성공적으로 완료되었습니다. |
|
필터링할 파일이 이전에 로드되지 않았습니다. |
|
특성의 개수 및 내용이 동의하지 않습니다. |
|
암호 보호 또는 유사한 보안 조치로 인해 액세스가 거부되었습니다. |
|
일반 액세스 실패 |
설명
Init 메서드는 필터 개체의 상태를 설정합니다. 콘텐츠 필터는 개체의 시작 부분에 위치하며 개체가 해제될 때까지 개체 상태가 고정됩니다. aAttributes 배열에서 속성 집합 및 속성 식별자(ID) 설명을 설정하여 반환하려는 속성 집합을 필터 개체에 전달할 수 있습니다. 자세한 내용은 파일 속성 필터링을 참조하세요.
발신자에 대한 참고 사항
다른 모든 IFilter 메서드를 호출하기 전에 Init 메서드를 호출합니다.구현자에 대한 참고 사항
청크 ID는 동일한 매개 변수를 사용하여 Init 메서드에 대한 여러 호출에서 일관성을 유지해야 합니다.IFilter 인터페이스의 일부 구현에서는 Init 메서드가 호출되거나 나중에 호출될 때까지 문서에 액세스하지 못하거나 계산 비용이 많이 들 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | filter.h |