¿Qué significa el código de error de Windows 0 (ERROR_SUCCESS)?

ERROR_SUCCESS

Qué significa ERROR_SUCCESS

ERROR_SUCCESS es el código Win32 0 (0x00000000) y significa que la operación terminó correctamente. No representa un error. Su interpretación debe hacerse según el contrato de la API que produjo el valor: algunas funciones devuelven un código Win32 directamente, mientras que otras indican éxito mediante su valor de retorno y solo permiten consultar GetLastError en condiciones concretas.

Un cero en GetLastError no siempre describe la llamada anterior

GetLastError mantiene un valor asociado al hilo, y una función que tiene éxito no está obligada a ponerlo a cero salvo que su documentación lo indique. Por eso, leerlo después de una llamada satisfactoria puede devolver un valor antiguo o ERROR_SUCCESS sin aportar información útil. Para diagnosticar correctamente, registre primero el valor de retorno de la API y compruebe las poscondiciones documentadas.

Cómo tratar el resultado

• No genere una alerta solo porque el código figure en un campo llamado «error».
• Conserve el nombre de la API y el dominio del código cuando un wrapper unifique Win32, HRESULT y NTSTATUS.
• Si el estado esperado no se alcanzó pese al código 0, investigue el contrato y los datos de salida en vez de «reparar» ERROR_SUCCESS.

Referencias técnicas

• Microsoft: System Error Codes 0–499
• Microsoft: GetLastError