IMFASFIndexer::CommitIndex-Methode (wmcontainer.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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 |