Metodo IFsiDirectoryItem::Add (imapi2fs.h)

Articolo
08/24/2023

Aggiunge un file o una directory descritta dall'oggetto IFsiItem all'immagine del file system.

Sintassi

HRESULT Add(
  [in] IFsiItem *item
);

Parametri

[in] item

Interfaccia IFsiItem dell'oggetto IFsiFileItem o IFsiDirectoryItem da aggiungere all'immagine del file system.

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_POINTER	Puntatore non valido. Valore: 0x80004003
IMAPI_E_INVALID_PATH	Percorso '%1!s!' non è formato correttamente o contiene caratteri non validi. Valore: 0xC0AAB110
IMAPI_E_DATA_STREAM_READ_FAILURE	Impossibile leggere i dati dal flusso fornito per il file '%1!ls!'. Valore: 0xC0AAB129
IMAPI_E_DUP_NAME	ls!' nome già esistente. Valore: 0xC0AAB112
IMAPI_E_NO_UNIQUE_NAME	Tentativo di aggiunta di '%1!ls!' failed: impossibile creare un nome univoco specifico del file system per %2!ls! . Valore: 0xC0AAB113
IMAPI_E_IMAGE_SIZE_LIMIT	Aggiunta di '%1!ls!' genererebbe un'immagine di risultato con dimensioni maggiori del limite configurato corrente. Valore: 0xC0AAB120
IMAPI_E_ISO9660_LEVELS	ISO9660 è limitato a 8 livelli di directory. Valore: 0xC0AAB131
IMAPI_E_TOO_MANY_DIRS	L'immagine del file system contiene troppe directory per %1!ls! . Valore: 0xC0AAB130
IMAPI_E_DIR_NOT_FOUND	Directory '%1!s!' non trovato nella gerarchia FileSystemImage. Valore: 0xC0AAB11A
IMAPI_E_NOT_IN_FILE_SYSTEM	Questo file o directory non fa parte del file system. È necessario aggiungerlo 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 maggiori del limite configurato corrente. Valore: 0xC0AAB120
E_OUTOFMEMORY	Impossibile allocare la memoria richiesta. Valore: 0x8007000E

Nota I valori restituiti dal metodo IUnknown::QueryInterface possono anche essere restituiti qui.

Commenti

Per creare un elemento di directory o un elemento di file, chiamare rispettivamente il metodo IFileSystemImage::CreateDirectoryItem o IFileSystemImage::CreateFileItem .

Dopo aver aggiunto un elemento all'immagine del file system, la proprietà IFsiFileItem::get_Data diventa di sola lettura.

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