IFsiDirectoryItem2::AddTreeWithNamedStreams-Methode (imapi2fs.h)
Fügt dem Dateisystemimage den Inhalt einer Verzeichnisstruktur zusammen mit benannten Streams hinzu, die allen Dateien zugeordnet sind.
Syntax
HRESULT AddTreeWithNamedStreams(
[in] BSTR sourceDirectory,
[in] VARIANT_BOOL includeBaseDirectory
);
Parameter
[in] sourceDirectory
Zeichenfolge, die den relativen Pfad der zu erstellenden Verzeichnisstruktur enthält. Der Pfad sollte nur gültige Zeichen gemäß den Dateisystembenennungskonventionen enthalten. Dieser Parameter darf nicht NULL sein.
[in] includeBaseDirectory
Legen Sie auf VARIANT_TRUE fest, um das Verzeichnis in sourceDirectory als Unterverzeichnis in das Dateisystemimage aufzunehmen. Andernfalls VARIANT_FALSE.
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/-wert | BESCHREIBUNG |
|---|---|
|
Das Feature wird für die aktuelle Dateisystemrevision nicht unterstützt und wird daher ohne dieses Feature erstellt. |
|
Der für den Parameter '%1!ls!' angegebene Wert ungültig. |
|
ls!" ist nicht Teil des Dateisystems. Sie muss hinzugefügt werden, um diesen Vorgang abzuschließen. |
|
Fehler beim Erstellen des Datenstroms für '%1!ls!'. |
|
Daten aus dem Datenstrom, der für die Datei '%1!ls!' bereitgestellt wird, können nicht gelesen werden. |
|
Das IFileSystemImage-Objekt befindet sich im schreibgeschützten Modus. |
|
'%1!ls!' Name ist bereits vorhanden. |
|
Das Hinzufügen von '%1!ls!' führt zu einem Ergebnisbild, das eine Größe über dem aktuell konfigurierten Grenzwert aufweist. |
|
Der für die Datei '%1!ls!' bereitgestellte Datenstrom ist inkonsistent. erwartet %2! I64d! bytes, gefunden %3! I64d! |
|
Fehler beim Zuweisen des erforderlichen Arbeitsspeichers. |
Hinweise
Das übergeordnete Verzeichnis für das neue Unterverzeichnis muss bereits innerhalb des Dateisystemimages vorhanden sein.
Die Unterverzeichnisstruktur innerhalb des angegebenen sourceDirectory wird implizit im Dateisystemimage gespiegelt. Wenn Datei- oder Verzeichniskonflikte auftreten, hat der Inhalt des angegebenen Quellverzeichnisses Vorrang.
Das Dateisystemimage wird mit den entsprechenden Verzeichnissen und Dateien aus dem Quellverzeichnis überschrieben. Wenn während der Verarbeitung eine Ausnahme auftritt, wird das Dateisystemimage in den vorherigen Zustand zurückgesetzt.
Wenn diese Methode für ein Dateisystemobjekt aufgerufen wird, das keine UDF in der Liste der Dateisysteme enthält, die für die Erstellung im resultierenden Image aktiviert sind, oder wenn die UDF-Revision unter 2.00 liegt, gibt diese Methode Erfolgscode IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED zurück. Dies gibt an, dass die benannten Datenströme hinzugefügt wurden, aber nicht im resultierenden Dateisystemimage angezeigt werden, es sei denn, die UDF-Revision 2.00 oder höher ist im Dateisystemobjekt aktiviert.
Bei der Verwendung alternativer Datenströme (ADS) ist es wichtig zu beachten, dass das Dateisystemimage eine Einschränkung von 1000 Streams aufweist. Eine Überschreitung dieser Zahl führt zu Datenverlusten.
Diese Methode wird in Windows Server 2003 mit Service Pack 1 (SP1), Windows XP mit Service Pack 2 (SP2) und Windows Vista über das Windows Feature Pack for Storage unterstützt. Alle Features dieses Updatepakets werden in Windows 7 und Windows Server 2008 R2 nativ unterstützt.
Anforderungen
| 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 |