Compartilhar via

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

  • Artigo

Adiciona um arquivo ou diretório descrito pelo objeto IFsiItem à imagem do sistema de arquivos.

Sintaxe

HRESULT Add(
  [in] IFsiItem *item
);

Parâmetros

[in] item

Uma interface IFsiItem do IFsiFileItem ou IFsiDirectoryItem para adicionar à imagem do sistema de arquivos.

Retornar valor

S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno Descrição
E_POINTER
 O ponteiro não é válido.

Valor: 0x80004003
IMAPI_E_INVALID_PATH
 Caminho '%1!s!' é mal formado ou contém caracteres inválidos.

Valor: 0xC0AAB110
IMAPI_E_DATA_STREAM_READ_FAILURE
 Não é possível ler dados do fluxo fornecido para o arquivo '%1!ls!'.

Valor: 0xC0AAB129
IMAPI_E_DUP_NAME
 ls! O nome já existe.

Valor: 0xC0AAB112
IMAPI_E_NO_UNIQUE_NAME
 Tentativa de adicionar '%1!ls!' falha: não é possível criar um nome exclusivo específico do sistema de arquivos para o %2!ls! .

Valor: 0xC0AAB113
IMAPI_E_IMAGE_SIZE_LIMIT
 Adicionando '%1!ls!' resultaria em uma imagem de resultado com um tamanho maior que o limite configurado atual.

Valor: 0xC0AAB120
IMAPI_E_ISO9660_LEVELS
 ISO9660 é limitado a 8 níveis de diretórios.

Valor: 0xC0AAB131
IMAPI_E_TOO_MANY_DIRS
 Esta imagem do sistema de arquivos tem muitos diretórios para %1!ls! .

Valor: 0xC0AAB130
IMAPI_E_DIR_NOT_FOUND
 O diretório '%1!s!' não encontrado na hierarquia FileSystemImage.

Valor: 0xC0AAB11A
IMAPI_E_NOT_IN_FILE_SYSTEM
 Esse arquivo ou diretório não faz parte do sistema de arquivos. Ele deve ser adicionado para concluir esta operação.

Valor: 0xC0AAB10B
IMAPI_E_READONLY
 O objeto FileSystemImage está no modo somente leitura.

Valor: 0xC0AAB102
IMAPI_E_IMAGE_SIZE_LIMIT
Adicionar esse arquivo ou diretório resultaria em uma imagem de resultado com um tamanho maior que o limite configurado atual.

Valor: 0xC0AAB120
E_OUTOFMEMORY
 Falha ao alocar a memória necessária.

Valor: 0x8007000E
 
Nota Os valores retornados pelo método IUnknown::QueryInterface também podem ser retornados aqui.
 

Comentários

Para criar um item de diretório ou item de arquivo, chame o método IFileSystemImage::CreateDirectoryItem ou IFileSystemImage::CreateFileItem , respectivamente.

Depois que um item é adicionado à imagem do sistema de arquivos, a propriedade IFsiFileItem::get_Data se torna somente leitura.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho imapi2fs.h

Confira também

IFsiDirectoryItem

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::Remove

IFsiFileItem