Compartir a través de

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

  • Artículo

Asocia una secuencia con nombre a un archivo específico en la imagen del sistema de archivos.

Sintaxis

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

Parámetros

[in] name

Una cadena representa el nombre de la secuencia con nombre. 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.

[in] streamData

Interfaz IStream de la secuencia con nombre utilizada para escribir en la imagen del sistema de archivos resultante.

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

El archivo al que se agregará la secuencia con nombre ya debe existir en la imagen del sistema de archivos. Si se llama a este método con un nombre que ya existe para una secuencia con nombre, devolverá un error y no reemplazará la secuencia con nombre existente.

Si se invoca este método para un objeto de sistema de archivos que no contiene UDF en la lista de sistemas de archivos habilitados para la creación en la imagen resultante o si la revisión de la UDF es inferior a la 2.00, este método devuelve el código correcto IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED. Este código correcto indica que se ha agregado la secuencia con nombre, pero no aparecerá en la imagen del sistema de archivos resultante a menos que la revisión 2.00 UDF o posterior esté habilitada en el objeto del sistema de archivos.

Actualmente, se devuelve IMAPI_E_READONLY cuando se llama a este método en una imagen de sistema de archivos importada, independientemente del estado de solo lectura de la imagen.

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

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