Compartir a través de

Método IFsiDirectoryItem::Add (imapi2fs.h)

  • Artículo

Agrega un archivo o directorio descrito por el objeto IFsiItem a la imagen del sistema de archivos.

Sintaxis

HRESULT Add(
  [in] IFsiItem *item
);

Parámetros

[in] item

Interfaz IFsiItem de IFsiFileItem o IFsiDirectoryItem para agregar a la imagen 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 códigos de error siguientes se devuelven normalmente en caso de error de operación, pero no representan los únicos valores de error posibles:

Código devuelto Descripción
E_POINTER
 El puntero no es válido.

Valor: 0x80004003
IMAPI_E_INVALID_PATH
 Ruta de acceso '%1!s!' tiene un formato incorrecto o contiene caracteres no válidos.

Valor: 0xC0AAB110
IMAPI_E_DATA_STREAM_READ_FAILURE
 No se pueden leer datos de la secuencia proporcionada para el archivo '%1!ls!'.

Valor: 0xC0AAB129
IMAPI_E_DUP_NAME
 ¡ls!' el nombre ya existe.

Valor: 0xC0AAB112
IMAPI_E_NO_UNIQUE_NAME
 Intente agregar '%1!ls!' error: no se puede crear un nombre único específico del sistema de archivos para %2!ls! .

Valor: 0xC0AAB113
IMAPI_E_IMAGE_SIZE_LIMIT
 Agregar '%1!ls!' daría lugar a que una imagen de resultado tenga un tamaño mayor que el límite configurado actual.

Valor: 0xC0AAB120
IMAPI_E_ISO9660_LEVELS
 ISO9660 se limita a 8 niveles de directorios.

Valor: 0xC0AAB131
IMAPI_E_TOO_MANY_DIRS
 Esta imagen del sistema de archivos tiene demasiados directorios para %1!ls! .

Valor: 0xC0AAB130
IMAPI_E_DIR_NOT_FOUND
 El directorio '%1!s!' no se encuentra en la jerarquía FileSystemImage.

Valor: 0xC0AAB11A
IMAPI_E_NOT_IN_FILE_SYSTEM
 Este archivo o directorio no forma parte del sistema de archivos. Se debe agregar para completar esta operación.

Valor: 0xC0AAB10B
IMAPI_E_READONLY
 El objeto FileSystemImage está en modo de solo lectura.

Valor: 0xC0AAB102
IMAPI_E_IMAGE_SIZE_LIMIT
Agregar este archivo o directorio daría lugar a que una imagen de resultado tenga un tamaño mayor que el límite configurado actual.

Valor: 0xC0AAB120
E_OUTOFMEMORY
 No se pudo asignar la memoria necesaria.

Valor: 0x8007000E
 
Nota Los valores devueltos por el método IUnknown::QueryInterface también se pueden devolver aquí.
 

Comentarios

Para crear un elemento de directorio o un elemento de archivo, llame al método IFileSystemImage::CreateDirectoryItem o IFileSystemImage::CreateFileItem , respectivamente.

Una vez que se agrega un elemento a la imagen del sistema de archivos, la propiedad IFsiFileItem::get_Data se convierte en de solo lectura.

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

IFsiDirectoryItem

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::Remove

IFsiFileItem