IMFASFIndexer::CommitIndex-Methode (wmcontainer.h)

  • Artikel

Fügt dem ContentInfo-Objekt, das ASF-Inhalten zugeordnet ist, Informationen zu einem neuen Index hinzu. Sie müssen diese Methode aufrufen, bevor Sie den Index in den Inhalt kopieren, damit der Index später vom Indexer lesbar ist.

Syntax

HRESULT CommitIndex(
  [in] IMFASFContentInfo *pIContentInfo
);

Parameter

[in] pIContentInfo

Zeiger auf die IMFASFContentInfo-Schnittstelle des ContentInfo-Objekts, das den Inhalt beschreibt.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_INVALIDREQUEST
 Der Aufrufer hat eine ungültige Anforderung gestellt. Weitere Informationen finden Sie in den Hinweisen.

Hinweise

Damit der Index ordnungsgemäß funktioniert, müssen Sie diese Methode aufrufen, nachdem alle ASF-Pakete in der Datei mithilfe der IMFASFIndexer:GenerateIndexEntries-Methode an den Indexer übergeben wurden. Nachdem Sie diese Methode aufgerufen haben, müssen Sie die Indizes abrufen, indem Sie GetCompletedIndex aufrufen und sie an den entsprechenden Speicherort in der Datei schreiben. Schließlich müssen Sie einen neuen ASF-Header generieren, indem Sie die IMFASFContentInfo::GenerateHeader-Methode des ASF ContentInfo-Objekts aufrufen.

Eine Anwendung muss die CommitIndex-Methode nur beim Schreiben eines neuen Index verwenden, andernfalls gibt CommitIndex möglicherweise MF_E_INVALIDREQUEST zurück. Beispielsweise wird MF_E_INVALIDREQUEST zurückgegeben, wenn die Anwendung andere Flags als MFASF_INDEXER_WRITE_NEW_INDEX für das Indexerobjekt festgelegt hat. CommitIndex kann auch MFASF_INDEXER_WRITE_NEW_INDEX zurückgeben, wenn die Indexeinträge bereits über einen früheren CommitIndex-Aufruf committet wurden.

Sie können diese Methode nicht in einem Indexleseszenario verwenden. Sie können diese Methode nur beim Schreiben von Indizes verwenden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wmcontainer.h
Bibliothek Mfuuid.lib

Weitere Informationen

ASF Index-Objekt

IMFASFIndexer

MFCreateASFIndexer