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

El método DestroyElement quita el almacenamiento o la secuencia especificados de este objeto de almacenamiento.

Sintaxis

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

Parámetros

[in] pwcsName

Puntero a una cadena Unicode terminada en null de caracteres anchos que contiene el nombre del almacenamiento o secuencia que se va a quitar.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El elemento se quitó correctamente.
E_PENDING	Solo almacenamiento asincrónico: la parte o todos los datos del elemento no están disponibles actualmente.
STG_E_ACCESSDENIED	El autor de la llamada no tiene permisos para quitar el elemento.
STG_E_FILENOTFOUND	El elemento con el nombre especificado no existe.
STG_E_INSUFFICIENTMEMORY	El elemento no se quitó debido a una falta de memoria.
STG_E_INVALIDNAME	Valor no válido para pwcsName.
STG_E_INVALIDPOINTER	El puntero especificado para el elemento no era válido.
STG_E_INVALIDPARAMETER	Uno de los parámetros no era válido.
STG_E_REVERTED	El objeto de almacenamiento se ha invalidado mediante una operación de reversión encima de él en el árbol de transacciones.
STG_E_TOOMANYOPENFILES	El elemento no se quitó porque hay demasiados archivos abiertos.

Comentarios

El método DestroyElement elimina un substorage o una secuencia del objeto de almacenamiento actual. Después de una llamada correcta a DestroyElement, cualquier instancia abierta del elemento destruido del almacenamiento primario deja de ser válida.

Si se abre un objeto de almacenamiento en el modo de transacción, la destrucción de un elemento requiere que la llamada a DestroyElement vaya seguida de una llamada a IStorage::Commit.

Nota El método DestroyElement no reduce la secuencia de directorios. Solo marca la entrada de directorio eliminada como no válida. Las entradas no válidas se reutilizan al crear un nuevo almacenamiento o secuencia.

En el caso de los flujos de contenido, los sectores de flujo eliminados se marcan como gratuitos. Si los sectores libres están al final del archivo, el archivo de documento debe reducirse. Para compactar un archivo de documento, llame a IStorage::CopyTo en el objeto de almacenamiento raíz y copie en un nuevo objeto de almacenamiento.

 

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	objidl.h
Library	Uuid.lib
Archivo DLL	Ole32.dll

Consulte también

IStorage: implementación de archivos compuestos