2.8 KiB
2.8 KiB
source_files, generated_at, model, schema_version, sha256
| source_files | generated_at | model | schema_version | sha256 | |
|---|---|---|---|---|---|
|
2026-04-17T16:29:44.608866+00:00 | zai-org/GLM-5-FP8 | 1 | cd3e42ca1eeef316 |
Errors
Purpose
This module defines a centralized registry of error codes used throughout the DbAPI system. It provides a standardized set of error constants (both system-level and application-specific) and a utility method for converting error codes to human-readable strings, enabling consistent error handling and reporting across the codebase.
Public Interface
Class: ErrorCodes (abstract)
public const ulong ERROR_SUCCESS = 0x0- Indicates successful operation completion.public const ulong ERROR_INVALID_FUNCTION = 0x1- Invalid function was called.public const ulong ERROR_FILE_NOT_FOUND = 0x2- Specified file could not be located.public const ulong ERROR_PATH_NOT_FOUND = 0x3- Specified path could not be located.public const ulong ERROR_ACCESS_DENIED = 0x5- Access was denied to the requested resource.public const ulong ERROR_NOT_SUPPORTED = 0x32- The requested operation is not supported.public const ulong INVALID_SESSIONID = 0x200- Session identifier is invalid or expired.public const ulong ERROR_UNKNOWN = 0x201- An unknown/unexpected error occurred.public const ulong ERROR_NOUSER = 0x202- No user is associated with the operation.public const ulong ERROR_LOGINFAILED = 0x203- Login attempt failed.public const ulong ERROR_MISSING_PARAMETER = 0x204- A required parameter was not provided.public static string ResultToString(ulong hr)- Converts an error code to its string representation. Returns the symbolic name for known codes (e.g., "SUCCESS", "ACCESS_DENIED") or the hexadecimal representation for unknown codes.
Invariants
- All error codes are defined as
ulong(unsigned 64-bit integers). ERROR_SUCCESS(0x0) is the only success code; all non-zero values indicate errors.- System-level errors (0x0-0x32 range) mirror Windows error codes.
- Application-specific errors start at 0x200.
- The class is
abstract, preventing instantiation (intended to be used only for its static members).
Dependencies
- Depends on: None (standalone module with no imports).
- Depended on by: Unclear from source alone; likely consumed by all DbAPI components for error handling and reporting.
Gotchas
ERROR_MISSING_PARAMETERis defined as a constant but is not handled in theResultToStringswitch statement—it will return the hex string "204" instead of a symbolic name.- The class is
abstractbut contains no virtual or abstract members; it functions as a static utility class pattern but could have been declaredstaticinstead. - Error code values 0x4, 0x6-0x31 are undefined/skipped in the constants list despite being in the system error range.