Compartilhar via

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

  • Artigo

Remova a árvore de diretório especificada da imagem do sistema de arquivos.

Sintaxe

HRESULT RemoveTree(
  [in] BSTR path
);

Parâmetros

[in] path

Cadeia de caracteres que contém o nome do diretório a ser removido. O caminho é relativo ao item de diretório atual.

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 parâmetro path não é um ponteiro válido.
IMAPI_E_INVALID_PARAM
 O valor especificado para o parâmetro %1!ls! não é válido.

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

Valor: 0xC0AAB110
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
IMAPI_E_DIR_NOT_FOUND
 O diretório especificado não existe.
IMAPI_E_DIR_NOT_EMPTY
 O diretório %1!s! não está vazio.

Valor: 0xC0AAB10A
IMAPI_E_FSI_INTERNAL_ERROR
 Erro interno: %1!ls!.

Valor: 0xC0AAB100
IMAPI_E_NOT_DIR
 O caminho especificado %1!ls! não identifica um diretório.

Valor: 0xC0AAB109

Comentários

O item de diretório deve estar presente na imagem do sistema de arquivos.

Você pode excluir toda a imagem do sistema de arquivos chamando esse método para o item de diretório raiz e definindo o caminho como um delimitador de caminho único (\).

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

IFsiDirectoryItem

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::AddTree

IFsiDirectoryItem::Remove