IFileSystemImage::get_StageFiles-Methode (imapi2fs.h)
Gibt an, ob die Dateien, die dem Dateisystemimage hinzugefügt werden, vor dem Brennvorgang inszeniert werden sollen.
Syntax
HRESULT get_StageFiles(
[out] VARIANT_BOOL *pVal
);
Parameter
[out] pVal
VARIANT_TRUE , wenn die Dateien, die dem Dateisystemimage hinzugefügt werden, vor dem Brennen in einer oder mehreren Phasendateien bereitgestellt werden müssen. Andernfalls wird VARIANT_FALSE zurückgegeben, wenn IMAPI berechtigt ist, den Prozess der Imageerstellung zu optimieren, indem die Dateien, die dem Dateisystemimage hinzugefügt werden, nicht inszeniert werden.
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:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Zeiger ist ungültig.
Wert: 0x80004003 |
Hinweise
"Staging" ist ein Prozess, bei dem ein Image auf der Festplatte erstellt wird, das alle zu brennenden Dateien enthält, bevor der Brennvorgang initiiert wird.
Wenn Sie diese Eigenschaft über IFileSystemImage::p ut_StageFiles auf VARIANT_TRUE festlegen, wirkt sich dies nur auf Dateien aus, die nach dem Festlegen der Eigenschaft hinzugefügt werden: Diese Dateien werden immer inszeniert. Dateien, die nicht vor einem angegebenen Eigenschaftswert von VARIANT_TRUE bereitgestellt wurden, werden nicht inszeniert.
Durch Angabe VARIANT_FALSE wird der Prozess zur Erstellung von Dateisystemimages auf zwei Arten optimiert:
- Weniger Zeit für die Imagegenerierung
- Weniger Speicherplatz auf einem lokalen Datenträger durch IMAPI
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2fs.h |