IJolietDiscMaster::AddData-Methode (imapi.h)
Fügt der Datei mit mehrstufigem Image den Inhalt eines Stammspeichers hinzu. Dieser Speicher wird aufgelistet, um alle Unterspeicher und Streams im Stammdateisystem der Bühnenbilddatei zu platzieren. Aus Unterspeichern werden Ordner und Datenströme zu Dateien. Mehrere Aufrufe dieser Methode können wiederholt werden, um eine Imagedatei langsam zu inszenieren, ohne übermäßige Mengen an Festplattenspeicherplatz beim Erstellen einer Speicherdatei zu verschwenden.
Syntax
HRESULT AddData(
[in] IStorage *pStorage,
[in] long lFileOverwrite
);
Parameter
[in] pStorage
Pfad zum Speicher, dessen Unterelemente dem Stamm der datei mit mehrstufigem Image hinzugefügt werden sollen.
[in] lFileOverwrite
Wenn dieser Parameter ungleich null ist, überschreiben Sie vorhandene Dateien mit demselben Namen. Andernfalls wird die zuletzt hinzugefügte Datei im Verzeichnis angezeigt.
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:
Hinweise
Wenn Sie einen AddData-Vorgang wiederholen, führen Ordner mit doppelten Dateien zu einem Test von lFileOverwrite. Wenn das Flag ungleich null ist, wird die Datei überschrieben. Frühere Dateien mit in Konflikt stehenden Namen werden weiterhin aus der Imagedatei auf den Datenträger geschrieben. Wenn lFileOverwrite null ist und eine Datei mit demselben Namen vorhanden ist, schlägt AddData mit IMAPI_E_FILEEXISTS fehl.
Während AddData nach dem Aufruf von IDiscMaster::SetActiveDiscRecorder mehrmals aufgerufen werden kann, muss SetActiveDiscRecorder immer aufgerufen werden, wenn ein neues Image gestartet wird, und unmittelbar vor dem ersten AddData-Aufruf, unabhängig davon, ob der Burner derselbe ist, der bei der vorherigen Imageerstellung verwendet wurde.
Wenn ein Aufruf dieser Methode die Anzahl der verfügbaren Datenblöcke überschreibt, gibt die Methode IMAPI_E_DISCFULL zurück und ignoriert alle Daten, die hinzugefügt werden sollten. Dadurch wird sichergestellt, dass das endgültige Joliet-Dateisystem nicht beschädigt ist.
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 |