IDiscMaster::ClearFormatContent-Methode (imapi.h)

Löscht den Inhalt eines unverbrannten Bilds (die aktuelle Stashdatei).

Syntax

HRESULT ClearFormatContent();

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:

Hinweise

Die Stashdatei ist eine interne Struktur, die verwendet wird, um einen Datenträger zu inszenieren, bevor er auf Medien aufgezeichnet wird.

SetActiveDiscRecorder bestimmt, ob im aktiven Laufwerk ein IMAPI-Datenträger mit mehreren Sitzungen vorhanden ist. Wenn ja, wechselt IMAPI automatisch in den Modus für mehrere Sitzungen. Die Verwendung von ClearFormatContent nach dem Eingerichteten Modus für mehrere Sitzungen führt dazu, dass IMAPI in den Einzelsitzungsmodus zurückkehrt. Dies bedeutet, dass für einen RecordDisc-Brennvorgang ein leerer Datenträger erforderlich ist.

Vorsicht Achten Sie beim Aufrufen dieser Methode auf Sorgfalt. Es gibt keine Bestätigung und keine Wiederherstellung. Wenn eine Anwendung die Bilddatei mit Daten füllt und diese Methode aufruft, sind die Daten weg.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	imapi.h
Bibliothek	Uuid.lib
DLL	Actxprxy.dll

Weitere Informationen

IDiscMaster