Metodo IFsiDirectoryItem2::AddTreeWithNamedStreams (imapi2fs.h)
Aggiunge il contenuto di un albero di directory insieme ai flussi denominati associati a tutti i file all'immagine del file system.
Sintassi
HRESULT AddTreeWithNamedStreams(
[in] BSTR sourceDirectory,
[in] VARIANT_BOOL includeBaseDirectory
);
Parametri
[in] sourceDirectory
Stringa contenente il percorso relativo dell'albero di directory da creare. Il percorso deve contenere solo caratteri validi in base alle convenzioni di denominazione del file system. Questo parametro non può essere NULL.
[in] includeBaseDirectory
Impostare su VARIANT_TRUE per includere la directory in sourceDirectory come sottodirectory nell'immagine del file system. In caso contrario, VARIANT_FALSE.
Valore restituito
S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:
| Codice/valore restituito | Descrizione |
|---|---|
|
La funzionalità non è supportata per la revisione corrente del file system e, di conseguenza, verrà creata senza questa funzionalità. |
|
Valore specificato per il parametro '%1!ls!' non è valido. |
|
ls!' non fa parte del file system. È necessario aggiungerlo per completare questa operazione. |
|
Errore durante la creazione del flusso di dati per '%1!ls!'. |
|
Impossibile leggere i dati dal flusso fornito per il file '%1!ls!'. |
|
L'oggetto IFileSystemImage a cui si fa riferimento è in modalità di sola lettura. |
|
'%1!ls!' nome già esistente. |
|
L'aggiunta di '%1!ls!' genera un'immagine di risultato con dimensioni maggiori del limite configurato corrente. |
|
Il flusso di dati fornito per il file '%1!ls!' è incoerente; previsto %2! I64d! byte trovati %3! I64d! |
|
Impossibile allocare la memoria richiesta. |
Commenti
La directory padre per la nuova sottodirectory deve esistere già all'interno dell'immagine del file system.
La struttura della sottodirectory specificata all'interno di sourceDirectory viene eseguito il mirroring implicito nell'immagine del file system. Se si verificano conflitti di file o directory, prevale il contenuto della directory di origine specificata.
L'immagine del file system viene sovrascritta con le directory e i file appropriati dalla directory di origine. Se si verifica un'eccezione durante l'elaborazione, l'immagine del file system torna allo stato precedente.
Se questo metodo viene richiamato per un oggetto file system che non contiene funzioni definite dall'utente nell'elenco dei file system abilitati per la creazione nell'immagine risultante o se la revisione della funzione definita dall'utente è inferiore alla 2.00, questo metodo restituisce il codice di operazione riuscita IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED. Ciò indica che i flussi denominati sono stati aggiunti ma non verranno visualizzati nell'immagine del file system risultante, a meno che la revisione definita dall'utente 2.00 o successiva non sia abilitata nell'oggetto file system.
Quando si usano flussi di dati alternativi (ADS), è importante notare che l'immagine del file system presenta una limitazione di 1000 flussi. Il superamento di questo numero comporterà la perdita di dati.
Questo metodo è supportato in Windows Server 2003 con Service Pack 1 (SP1), Windows XP con Service Pack 2 (SP2) e Windows Vista tramite Windows Feature Pack per l'archiviazione. Tutte le funzionalità fornite da questo pacchetto di aggiornamento sono supportate in modo nativo in Windows 7 e Windows Server 2008 R2.
Requisiti
| Client minimo supportato | Windows Vista, Windows XP con SP2 [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | imapi2fs.h |