Metodo IFsiFileItem2::RemoveStream (imapi2fs.h)

Articolo
03/14/2023

Rimuove un'associazione di flusso denominata con un file.

Sintassi

HRESULT RemoveStream(
  [in] BSTR name
);

Parametri

[in] name

Stringa che specifica il nome dell'associazione di flusso denominata da rimuovere. Questo non deve includere il percorso e deve contenere solo caratteri validi in base alle convenzioni di denominazione 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/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

Questo metodo può essere chiamato solo per gli elementi di file presenti nell'immagine del file system.

L'utente deve abilitare la funzione definita dall'utente e impostare la revisione definita dall'utente su 2.00 o versione successiva per supportare flussi denominati.

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

Vedi anche

IFsiFileItem2

IFsiFileItem2::AddStream

Condividi tramite