Metodo IStorage::D estroyElement (objidl.h)
Il metodo DestroyElement rimuove l'archiviazione o il flusso specificato da questo oggetto di archiviazione.
Sintassi
HRESULT DestroyElement(
[in] const OLECHAR *pwcsName
);
Parametri
[in] pwcsName
Puntatore a una stringa Unicode con terminazione null di caratteri wide contenente il nome dell'archiviazione o del flusso da rimuovere.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
| S_OK | L'elemento è stato rimosso correttamente. |
| E_PENDING | Solo archiviazione asincrona: parte o tutti i dati dell'elemento non sono attualmente disponibili. |
| STG_E_ACCESSDENIED | Il chiamante non dispone delle autorizzazioni per rimuovere l'elemento. |
| STG_E_FILENOTFOUND | L'elemento con il nome specificato non esiste. |
| STG_E_INSUFFICIENTMEMORY | L'elemento non è stato rimosso a causa di una mancanza di memoria. |
| STG_E_INVALIDNAME | Valore non valido per pwcsName. |
| STG_E_INVALIDPOINTER | Il puntatore specificato per l'elemento non è valido. |
| STG_E_INVALIDPARAMETER | Uno dei parametri non è valido. |
| STG_E_REVERTED | L'oggetto di archiviazione è stato invalidato da un'operazione di ripristino sopra di essa nell'albero delle transazioni. |
| STG_E_TOOMANYOPENFILES | L'elemento non è stato rimosso perché sono presenti troppi file aperti. |
Commenti
Il metodo DestroyElement elimina una sottostorage o un flusso dall'oggetto di archiviazione corrente. Dopo una chiamata riuscita a DestroyElement, qualsiasi istanza aperta dell'elemento eliminato dall'archiviazione padre non è valida.
Se un oggetto di archiviazione viene aperto nella modalità transazionata, la distruzione di un elemento richiede che la chiamata a DestroyElement venga seguita da una chiamata a IStorage::Commit.
Per i flussi di contenuto, i settori di flusso eliminati sono contrassegnati come gratuiti. Se i settori liberi si trovano alla fine del file, il file di documento deve essere ridotto. Per compattare un file di documento, chiamare IStorage::CopyTo nell'oggetto di archiviazione radice e copiare in un nuovo oggetto di archiviazione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | objidl.h |
| Libreria | Uuid.lib |
| DLL | Ole32.dll |