Método IStorage::D estroyElement (objidl.h)

  • Artigo

O método DestroyElement remove o armazenamento ou fluxo especificado desse objeto de armazenamento.

Sintaxe

HRESULT DestroyElement(
  [in] const OLECHAR *pwcsName
);

Parâmetros

[in] pwcsName

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo largo que contém o nome do armazenamento ou fluxo a ser removido.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK O elemento foi removido com êxito.
E_PENDING Somente armazenamento assíncrono: parte ou todos os dados do elemento não estão disponíveis no momento.
STG_E_ACCESSDENIED O chamador não tem permissões para remover o elemento.
STG_E_FILENOTFOUND O elemento com o nome especificado não existe.
STG_E_INSUFFICIENTMEMORY O elemento não foi removido devido à falta de memória.
STG_E_INVALIDNAME Valor inválido para pwcsName.
STG_E_INVALIDPOINTER O ponteiro especificado para o elemento não era válido.
STG_E_INVALIDPARAMETER Um dos parâmetros não era válido.
STG_E_REVERTED O objeto de armazenamento foi invalidado por uma operação de reverter acima dele na árvore de transações.
STG_E_TOOMANYOPENFILES O elemento não foi removido porque há muitos arquivos abertos.

Comentários

O método DestroyElement exclui um subtorage ou fluxo do objeto de armazenamento atual. Após uma chamada bem-sucedida para DestroyElement, qualquer instância aberta do elemento destruído do armazenamento pai se torna inválida.

Se um objeto de armazenamento for aberto no modo transacionado, a destruição de um elemento exigirá que a chamada para DestroyElement seja seguida por uma chamada para IStorage::Commit.

Nota O método DestroyElement não reduz o fluxo de diretório. Ele marca apenas a entrada de diretório excluída como inválida. Entradas inválidas são reutilizados ao criar um novo armazenamento ou fluxo.

Para fluxos de conteúdo, os setores de fluxo excluídos são marcados como gratuitos. Se os setores livres estiverem no final do arquivo, o arquivo de documento deverá ser reduzido. Para compactar um arquivo de documento, chame IStorage::CopyTo no objeto de armazenamento raiz e copie para um novo objeto de armazenamento.

 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho objidl.h
Biblioteca Uuid.lib
DLL Ole32.dll

Confira também

IStorage – Implementação de arquivo composto