IMFASFIndexer::SetIndexStatus 메서드(wmcontainer.h)

스트림에 대한 인덱스를 구성합니다.

구문

HRESULT SetIndexStatus(
  [in] BYTE  *pbIndexDescriptor,
  [in] DWORD cbIndexDescriptor,
  [in] BOOL  fGenerateIndex
);

[in] pbIndexDescriptor

설정할 인덱스 설명자입니다. 인덱스 설명자는 ASF_INDEX_DESCRIPTOR 구조체이며 선택적으로 인덱스 관련 데이터가 뒤따릅니다.

[in] cbIndexDescriptor

인덱스 설명자의 크기(바이트)입니다.

[in] fGenerateIndex

부울 값입니다. 인덱서가 인덱스 설명자에 지정된 스트림에 대해 지정된 형식의 인덱스 만들기를 하려면 TRUE 로 설정합니다.

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	설명
S_OK	메서드가 성공했습니다.
MF_E_INVALIDREQUEST	검색 전용 시나리오에서 인덱스 상태 변경하려고 했습니다. 자세한 내용은 설명 부분을 참조하세요.

IMFASFIndexer::GenerateIndexEntries를 호출하기 전에 SetIndexStatus를 모두 호출해야 합니다.

인덱서 개체는 기본적으로 각 스트림에 대한 임시 인덱스를 만들도록 구성됩니다. 기본 설정을 재정의하려는 경우에만 이 메서드를 호출합니다.

인덱스 읽기 시나리오에서는 이 메서드를 사용할 수 없습니다. 인덱스를 작성할 때만 이 메서드를 사용할 수 있습니다.