Metodo IFsiDirectoryItem::AddTree (imapi2fs.h)

Articolo
08/24/2023

Aggiunge il contenuto di un albero di directory all'immagine del file system.

Sintassi

HRESULT AddTree(
  [in] BSTR         sourceDirectory,
  [in] VARIANT_BOOL includeBaseDirectory
);

Parametri

[in] sourceDirectory

Stringa contenente il percorso relativo dell'albero della directory da creare.

Specificare il percorso completo quando si chiama questo metodo dall'elemento della directory radice.

[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 restituito	Descrizione
E_OUTOFMEMORY	Impossibile allocare la memoria necessaria. Valore: 0x8007000E
E_POINTER	Puntatore non valido. Valore: 0x80004003
IMAPI_E_DIRECTORY_READ_FAILURE	L'enumerazione dei file nell'albero delle directory non è accessibile a causa delle autorizzazioni. Valore: 0xC0AAB12BL
IMAPI_E_DATA_STREAM_CREATE_FAILURE	Uno o più file nell'albero delle directory non è accessibile a causa delle autorizzazioni. Valore: 0xC0AAB12A
IMAPI_E_DATA_STREAM_READ_FAILURE	Impossibile leggere i dati dal flusso fornito per il file '%1!ls!'. Valore: 0xC0AAB129
IMAPI_E_INVALID_PARAM	Il valore specificato per il parametro %1!ls! non è valido. Valore: 0xC0AAB101
IMAPI_E_NOT_IN_FILE_SYSTEM	ls!' non fa parte del file system. Deve essere aggiunto per completare questa operazione. Valore: 0xC0AAB10B
IMAPI_E_READONLY	L'oggetto FileSystemImage è in modalità di sola lettura. Valore: 0xC0AAB102
IMAPI_E_IMAGE_SIZE_LIMIT	L'aggiunta di questo file o directory comporta un'immagine di risultato con dimensioni superiori al limite configurato corrente. Valore: 0xC0AAB120
IMAPI_E_INVALID_PATH	Percorso '%1!s!' è formato male o contiene caratteri non validi. Valore: 0xC0AAB110
IMAPI_E_DUP_NAME	ls!' nome già esistente. Valore: 0xC0AAB112
IMAPI_E_NO_UNIQUE_NAME	Provare a aggiungere '%1!ls!' non riuscito: non è possibile creare un nome univoco specifico del file system per %2!ls! . Valore: 0xC0AAB113
IMAPI_E_ISO9660_LEVELS	ISO9660 è limitato a 8 livelli di directory. Valore: 0xC0AAB131
IMAPI_E_TOO_MANY_DIRS	Questa immagine del file system ha troppe directory per %1!ls! . Valore: 0xC0AAB130
IMAPI_E_DIR_NOT_FOUND	Directory '%1!s!' non trovato nella gerarchia FileSystemImage. Valore: 0xC0AAB11A

Nota I valori restituiti dalle funzioni GetFileAttributesEx e FindFirstFile possono essere restituiti qui.

Commenti

La directory padre per la nuova sottodirectory deve già esistere all'interno dell'immagine del file system.

La struttura della sottodirectory all'interno della directory di origine specificata è in modo implicito mirroring nell'immagine del file system.

Se si verificano collisioni tra file o directory, il contenuto della directory di origine specificata prevale. 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 ripristina lo stato precedente.

Requisiti

Requisito	Valore
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