¿Qué significa el código HRESULT 0x80030201 (STG_E_INCOMPLETE)?

STG_E_INCOMPLETE

Qué significa STG_E_INCOMPLETE

STG_E_INCOMPLETE corresponde al HRESULT 0x80030201. Una operación de almacenamiento quedó incompleta y necesita tratamiento explícito. La descripción de Windows para este valor es «La descarga del archivo se interrumpió de forma anómala. El archivo está incompleto.» y su origen se clasifica como winerror.h.

Puede haber datos parciales o una operación asíncrona que no alcanzó estado terminal. El caller debe saber qué parte quedó confirmada antes de repetir. Un wrapper puede traducir este HRESULT a una excepción genérica. En telemetría conviene guardar también el valor nativo y la operación COM antes de cruzar esa capa.

Comprobaciones específicas

• Registra bytes/etapas completados y cualquier token de progreso.
• Comprueba si el output parcial es visible o transacted.
• Separa cancelación, timeout y fallo del provider de este estado resumido.

Acción correctiva

Reanuda solo cuando la API lo soporte; de lo contrario descarta/rollback la salida parcial y reinicia desde un estado conocido.

Referencias técnicas

• Microsoft: Structured Storage
• Microsoft: IStorage
• Microsoft: IStream
• Microsoft: COM/STG error codes