Compartilhar via

Método IFsiFileItem2::RemoveStream (imapi2fs.h)

  • Artigo

Remove uma associação de fluxo nomeada com um arquivo.

Sintaxe

HRESULT RemoveStream(
  [in] BSTR name
);

Parâmetros

[in] name

Cadeia de caracteres que especifica o nome da associação de fluxo nomeada a ser removida. Isso não deve incluir o caminho e deve conter apenas caracteres válidos de acordo com as convenções de nomenclatura do sistema de arquivos.

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:

Valor/código retornado Descrição
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED
Valor: 0x00AAB15FL
 Não há suporte para o recurso para a revisão atual do sistema de arquivos e, como resultado, será criado sem esse recurso.
E_POINTER
Valor: 0x80004003
 O ponteiro não é válido.
IMAPI_E_INVALID_PARAM
Valor: 0xC0AAB101
 O valor especificado para o parâmetro '%1!ls!' será inválido.
IMAPI_E_NOT_IN_FILE_SYSTEM
Valor: 0xC0AAB10B
 ls! não faz parte do sistema de arquivos. Ele deve ser adicionado para concluir esta operação.
IMAPI_E_READONLY
Valor: 0xC0AAB102
 O objeto IFileSystemImage referenciado está no modo somente leitura.
IMAPI_E_FSI_INTERNAL_ERROR
Valor: 0xC0AAB100L
 Ocorreu um erro interno do sistema de arquivos.
IMAPI_E_DUP_NAME
Valor: 0xC0AAB112L
 '%1!ls!' o nome já existe.
IMAPI_E_DATA_STREAM_READ_FAILURE
Valor: 0xC0AAB129L
 Não é possível ler dados do fluxo fornecido para o arquivo '%1!ls!'.
IMAPI_E_IMAGE_SIZE_LIMIT
Valor: 0xC0AAB120L
 Adicionar '%1!ls!' resultaria em uma imagem de resultado com um tamanho maior que o limite configurado atualmente.
IMAPI_E_DATA_STREAM_INCONSISTENCY
Valor: 0xC0AAB128L
 O fluxo de dados fornecido para o arquivo '%1!ls!' é inconsistente; esperado %2! I64d! bytes, encontrado %3! I64d!
E_OUTOFMEMORY
Valor: 0x8007000EL
 Falha ao alocar memória necessária.

Comentários

Esse método só pode ser chamado para itens de arquivo presentes na imagem do sistema de arquivos.

O usuário deve habilitar o UDF e definir a revisão UDF como 2.00 ou superior para dar suporte a fluxos nomeados.

Esse método tem suporte no Windows Server 2003 com Service Pack 1 (SP1), Windows XP com Service Pack 2 (SP2) e Windows Vista por meio do Pacote de Recursos do Windows para Armazenamento. Todos os recursos fornecidos por este pacote de atualização têm suporte nativo no Windows 7 e no Windows Server 2008 R2.

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

IFsiFileItem2

IFsiFileItem2::AddStream