Compartilhar via

Método IFileSystemImage::CreateFileItem (imapi2fs.h)

  • Artigo

Crie um item de arquivo com o nome especificado.

Sintaxe

HRESULT CreateFileItem(
  [in]  BSTR         name,
  [out] IFsiFileItem **newItem
);

Parâmetros

[in] name

Cadeia de caracteres que contém o nome do item de arquivo a ser criado.

[out] newItem

Uma interface IFsiFileItem do novo item de arquivo. Quando terminar, chame o método IFsiFileItem::Release para liberar a interface.

Valor retornado

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 geralmente 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_PARAM
 O nome fornecido não é válido.

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

Valor: 0x8007000E

Comentários

Depois de definir propriedades na interface IFsiFileItem , chame o método IFsiDirectoryItem::Add no item de diretório pai para adicioná-lo à imagem do sistema de arquivos.

Requisitos

   
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

IFileSystemImage

IFsiFileItem