Compartir a través de

Método IFsiFileItem2::RemoveStream (imapi2fs.h)

  • Artículo

Quita una asociación de secuencia con nombre con un archivo.

Sintaxis

HRESULT RemoveStream(
  [in] BSTR name
);

Parámetros

[in] name

Cadena que especifica el nombre de la asociación de secuencia con nombre que se va a quitar. Esto no debe incluir la ruta de acceso y solo debe contener caracteres válidos según las convenciones de nomenclatura del sistema de archivos.

Valor devuelto

S_OK se devuelve correctamente, pero se pueden devolver otros códigos de éxito como resultado de la implementación. Los siguientes códigos de error se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:

Código o valor devuelto Descripción
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED
Valor: 0x00AAB15FL
 La característica no se admite para la revisión actual del sistema de archivos y, como resultado, se creará sin esta característica.
E_POINTER
Valor: 0x80004003
 El puntero no es válido.
IMAPI_E_INVALID_PARAM
Valor: 0xC0AAB101
 Valor especificado para el parámetro '%1!ls!' es no válido.
IMAPI_E_NOT_IN_FILE_SYSTEM
Valor: 0xC0AAB10B
 ¡ls!' no forma parte del sistema de archivos. Se debe agregar para completar esta operación.
IMAPI_E_READONLY
Valor: 0xC0AAB102
 El objeto IFileSystemImage al que se hace referencia está en modo de solo lectura.
IMAPI_E_FSI_INTERNAL_ERROR
Valor: 0xC0AAB100L
 Error interno del sistema de archivos.
IMAPI_E_DUP_NAME
Valor: 0xC0AAB112L
 '%1!ls!' el nombre ya existe.
IMAPI_E_DATA_STREAM_READ_FAILURE
Valor: 0xC0AAB129L
 No se pueden leer datos de la secuencia proporcionada para el archivo '%1!ls!'.
IMAPI_E_IMAGE_SIZE_LIMIT
Valor: 0xC0AAB120L
 Al agregar '%1!ls!', se produciría un tamaño mayor que el límite configurado actual.
IMAPI_E_DATA_STREAM_INCONSISTENCY
Valor: 0xC0AAB128L
 El flujo de datos proporcionado para el archivo '%1!ls!' es incoherente; se esperaba %2! ¡I64d! bytes, encontrado %3! ¡I64d!
E_OUTOFMEMORY
Valor: 0x8007000EL
 No se pudo asignar la memoria necesaria.

Comentarios

Solo se puede llamar a este método para los elementos de archivo presentes en la imagen del sistema de archivos.

El usuario debe habilitar UDF y establecer la revisión de UDF en 2.00 o superior para admitir flujos con nombre.

Este método se admite en Windows Server 2003 con Service Pack 1 (SP1), Windows XP con Service Pack 2 (SP2) y Windows Vista a través de Windows Feature Pack para Storage. Todas las características proporcionadas por este paquete de actualización se admiten de forma nativa en Windows 7 y Windows Server 2008 R2.

Requisitos

   
Cliente mínimo compatible Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imapi2fs.h

Consulte también

IFsiFileItem2

IFsiFileItem2::AddStream