Archivos incluidos:

• examples/csharp/APDUGT.cs — Wrapper P/Invoke con todas las estructuras y funciones
• examples/csharp/Program.cs — Ejemplo completo de uso

Compilar el ejemplo:

csc /out:test_APDUGT.exe Program.cs APDUGT.cs

Características del wrapper:

• Estructuras completas: DPIData, ReaderList, Reader
• Códigos de error como constantes en ErrorCodes
• Tipos de licencia en LicenseType
• Todas las funciones P/Invoke en la clase Native
• Compatible con .NET Framework 4.x y .NET Core/.NET 5+

Ejemplo básico:

import ctypes
from ctypes import Structure, c_char, c_int, c_uint, POINTER, byref

# Estructuras
class Reader(Structure):
    _fields_ = [("Name", c_char * 256)]

class ReaderList(Structure):
    _fields_ = [
        ("Readers", Reader * 16),
        ("Count", c_int)
    ]

# Cargar DLL (usar x64 o x86 según Python instalado)
dll = ctypes.WinDLL("./APDUGT.dll")

# Configurar tipos de retorno
dll.APDUGT_GetVersion.restype = ctypes.c_char_p
dll.APDUGT_ListReaders.argtypes = [POINTER(ReaderList)]
dll.APDUGT_GetCUI.argtypes = [c_int, ctypes.c_char_p]

# Obtener versión
version = dll.APDUGT_GetVersion()
print(f"Version: {version.decode()}")

# Listar lectores
readers = ReaderList()
if dll.APDUGT_ListReaders(byref(readers)) == 0:
    for i in range(readers.Count):
        print(f"Lector {i}: {readers.Readers[i].Name.decode()}")

# Leer CUI
cui = ctypes.create_string_buffer(32)
if dll.APDUGT_GetCUI(0, cui) == 0:
    print(f"CUI: {cui.value.decode()}")

Dependencia Maven:

<dependency>
    <groupId>net.java.dev.jna</groupId>
    <artifactId>jna</artifactId>
    <version>5.14.0</version>
</dependency>

Interface JNA:

import com.sun.jna.*;
import com.sun.jna.ptr.*;

public interface APDUGT extends StdCallLibrary {
    // Cargar con ruta relativa o absoluta
    APDUGT INSTANCE = Native.load("./APDUGT.dll", APDUGT.class);
    // O ruta absoluta: Native.load("C:/ruta/APDUGT.dll", APDUGT.class);

    // Estructura Reader
    public static class Reader extends Structure {
        public byte[] Name = new byte[256];
    }

    // Estructura ReaderList
    public static class ReaderList extends Structure {
        public Reader[] Readers = new Reader[16];
        public int Count;
    }

    // Funciones exportadas
    String APDUGT_GetVersion();
    int APDUGT_ListReaders(ReaderList readerList);
    int APDUGT_IsCardPresent(int readerIndex);
    int APDUGT_GetChipVersion(int readerIndex, byte[] version);
    int APDUGT_GetATR(int readerIndex, byte[] atr);
    int APDUGT_GetCUI(int readerIndex, byte[] cui);
    int APDUGT_GetLicenseType();
    int APDUGT_IsLicenseValid();
}

Ejemplo de uso:

public class Main {
    public static void main(String[] args) {
        APDUGT lib = APDUGT.INSTANCE;

        // Verificar licencia
        System.out.println("Version: " + lib.APDUGT_GetVersion());
        System.out.println("Licencia valida: " + (lib.APDUGT_IsLicenseValid() == 1));

        // Listar lectores
        APDUGT.ReaderList readers = new APDUGT.ReaderList();
        if (lib.APDUGT_ListReaders(readers) == 0) {
            System.out.println("Lectores: " + readers.Count);

            // Leer CUI del primer lector
            byte[] cui = new byte[32];
            if (lib.APDUGT_GetCUI(0, cui) == 0) {
                System.out.println("CUI: " + new String(cui).trim());
            }
        }
    }
}