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
//!
//! # Raw Excel 12 ABI layer
//!
//! This crate mirrors the checked-in Microsoft `XLCALL.H` Excel 12 C API
//! contract: fixed-width aliases, constants, `XLOPER12`-family layouts, and
//! callback function-pointer signatures. It is intended for audited FFI
//! boundaries on 64-bit Windows Excel, not for ordinary application code.
//!
//! The types and ownership bits describe an ABI; they do **not** make an
//! allocation safe to retain, mutate, free, or send across threads. In
//! particular, an `xlbitDLLFree` or `xlbitXLFree` tag is Excel protocol data,
//! not a Rust ownership type. Prefer [`excel_api`](https://docs.rs/excel-api)
//! for borrowed callback views, owned values, return allocation, and typed
//! callback contexts.
//!
//! # Direct-call safety
//!
//! A direct caller must verify the Excel callback context, `extern "system"`
//! calling convention, pointer alignment and accessible lengths, union tag,
//! allocation origin, and exact cleanup protocol. The initial support target is
//! 64-bit Excel; 32-bit layouts and non-Windows Excel hosts are unsupported.
//!
//! ```no_run
//! use excel_api_sys::{XLOPER12, XLOPER12Value, xltypeNum};
//!
//! let value = XLOPER12 { xltype: xltypeNum, val: XLOPER12Value { num: 42.0 } };
//! // SAFETY: this local value is tagged as `num`, so reading that selected
//! // union member is valid. This does not establish Excel callback legality,
//! // pointer validity, ownership, or worker-thread legality for a real call.
//! assert_eq!(unsafe { value.val.num }, 42.0);
//! ```
/// Raw SDK constants and function IDs.
///
/// The individual identifiers intentionally preserve `XLCALL.H` spelling and
/// are a mechanically audited compatibility surface; see the module-level
/// ownership and ABI rules above rather than treating a constant as a safe API.
/// Excel worksheet error codes.
/// Raw Excel callback and entry-point function signatures.
/// Raw C-layout Excel structures, unions, and primitive aliases.
pub use *;
pub use *;
pub use *;
pub use *;