Método IStorage::D estroyElement (objidl.h)
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.
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 |