Compartilhar via

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

  • Artigo

Adiciona um arquivo à imagem do sistema de arquivos.

Sintaxe

HRESULT AddFile(
  [in] BSTR    path,
  [in] IStream *fileData
);

Parâmetros

[in] path

Cadeia de caracteres que contém o caminho relativo do diretório para conter o novo arquivo.

Especifique o caminho completo ao chamar esse método do item de diretório raiz.

[in] fileData

Uma interface IStream do arquivo (fluxo de dados) para gravar na mídia.

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
IMAPI_E_INVALID_PATH
 Caminho '%1!s!' é mal formado ou contém caracteres inválidos.

Valor: 0xC0AAB110
E_POINTER
 O ponteiro não é válido.

Valor: 0x80004003
IMAPI_E_INVALID_PARAM
 O valor especificado para o parâmetro %1!ls! não é válido.

Valor: 0xC0AAB101
IMAPI_E_NOT_IN_FILE_SYSTEM
 ls! 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

Comentários

O diretório que conterá o novo arquivo já deve existir na imagem do sistema de arquivos.

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::Add

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::Remove