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.
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 |