Compartilhar via

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

  • Artigo

Crie um item de diretório com o nome especificado.

Sintaxe

HRESULT CreateDirectoryItem(
  [in]  BSTR              name,
  [out] IFsiDirectoryItem **newItem
);

Parâmetros

[in] name

Cadeia de caracteres que contém o nome do item de diretório a ser criado.

[out] newItem

Uma interface IFsiDirectoryItem do novo item de diretório. Quando terminar, chame o método IFsiDirectoryItem::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 valor especificado para o parâmetro %1!ls! 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 IFsiDirectoryItem , 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

IFsiDirectoryItem