xll-utils 0.1.0

PE/COFF parsing and export verification utilities for Excel XLL development
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

use std::path::PathBuf;

use crate::types::Architecture;

pub type Result<T> = std::result::Result<T, Error>;

#[derive(Debug, thiserror::Error)]
pub enum Error {
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

    #[error("Failed to open file '{path}': {source}")]
    FileOpen { path: PathBuf, source: std::io::Error },

    #[error("Failed to parse PE/COFF file: {0}")]
    PeParse(String),

    #[error("Export directory not found")]
    NoExportDirectory,

    #[error("Export table is corrupted or invalid")]
    InvalidExportTable,

    #[error("Expected {expected} exports, found {actual}")]
    ExportCountMismatch { expected: usize, actual: usize },

    #[error("Missing required export(s): {0}")]
    MissingExport(String),

    #[error("Export name mismatch: expected '{expected}', found '{actual}'")]
    NameMismatch { expected: String, actual: String },

    #[error("Export ordinal mismatch: name '{name}', expected ordinal {expected}, found {actual}")]
    OrdinalMismatch { name: String, expected: u32, actual: u32 },

    #[error("Not a valid DLL/EXE file")]
    InvalidFileFormat,

    #[error("Architecture mismatch: expected {expected}, found {actual}")]
    ArchMismatch {
        expected: Architecture,
        actual: Architecture,
    },

    #[error("Not a DLL file")]
    NotADll,

    #[error("Windows registry error: {0}")]
    Registry(String),

    #[error("Export not found: {0}")]
    ExportNotFound(String),

    #[error("No exports found in DLL")]
    NoExports,

    #[error("UTF-8 decoding error: {0}")]
    Utf8(#[from] std::string::FromUtf8Error),

    #[error("NUL character found in export name")]
    NulInName,

    #[cfg(feature = "serde")]
    #[error("JSON serialization error: {0}")]
    Json(#[from] serde_json::Error),
}