Compartilhar via

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

  • Artigo

Remove o item especificado da imagem do sistema de arquivos.

Sintaxe

HRESULT Remove(
  [in] BSTR path
);

Parâmetros

[in] path

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

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

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_OUTOFMEMORY
 Falha ao alocar a memória necessária.

Valor: 0x8007000E
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
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

Comentários

Esse método só pode ser chamado em itens de diretório presentes 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::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::RemoveTree