Metodo IFsiFileItem2::AddStream (imapi2fs.h)

Articolo
02/29/2024

Associa un flusso denominato a un file specifico nell'immagine del file system.

Sintassi

HRESULT AddStream(
  [in] BSTR    name,
  [in] IStream *streamData
);

Parametri

[in] name

Una stringa rappresenta il nome del flusso denominato. Questo non deve includere il percorso e deve contenere solo caratteri validi in base alle convenzioni di denominazione del file system.

[in] streamData

Interfaccia IStream del flusso denominato usata per scrivere nell'immagine del file system risultante.

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
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED Valore: 0x00AAB15FL	La funzionalità non è supportata per la revisione corrente del file system e, di conseguenza, verrà creata senza questa funzionalità.
E_POINTER Valore: 0x80004003	Puntatore non valido.
IMAPI_E_INVALID_PARAM Valore: 0xC0AAB101	Valore specificato per il parametro '%1!ls!' non è valido.
IMAPI_E_NOT_IN_FILE_SYSTEM Valore: 0xC0AAB10B	ls!' non fa parte del file system. È necessario aggiungerlo per completare questa operazione.
IMAPI_E_READONLY Valore: 0xC0AAB102	L'oggetto IFileSystemImage a cui si fa riferimento è in modalità di sola lettura.
IMAPI_E_FSI_INTERNAL_ERROR Valore: 0xC0AAB100L	Si è verificato un errore interno del file system.
IMAPI_E_DUP_NAME Valore: 0xC0AAB112L	'%1!ls!' nome già esistente.
IMAPI_E_DATA_STREAM_READ_FAILURE Valore: 0xC0AAB129L	Impossibile leggere i dati dal flusso fornito per il file '%1!ls!'.
IMAPI_E_IMAGE_SIZE_LIMIT Valore: 0xC0AAB120L	L'aggiunta di '%1!ls!' genera un'immagine di risultato con dimensioni maggiori del limite configurato corrente.
IMAPI_E_DATA_STREAM_INCONSISTENCY Valore: 0xC0AAB128L	Il flusso di dati fornito per il file '%1!ls!' è incoerente; previsto %2! I64d! byte trovati %3! I64d!
E_OUTOFMEMORY Valore: 0x8007000EL	Impossibile allocare la memoria richiesta.

Commenti

Il file a cui verrà aggiunto il flusso denominato deve esistere già all'interno dell'immagine del file system. Se questo metodo viene chiamato con un nome già esistente per un flusso denominato, restituirà un errore e non sostituirà il flusso denominato esistente.

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. Questo codice di operazione riuscita indica che il flusso denominato è stato aggiunto ma non verrà visualizzato 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.

Attualmente, IMAPI_E_READONLY viene restituito quando questo metodo viene chiamato su un'immagine del file system importata, indipendentemente dallo stato di sola lettura dell'immagine.

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

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

Vedi anche

IFsiFileItem2

Condividi tramite