DarException if extraction fails (permission denied, disk full,
invalid archive handle, corrupted data).
Example:
auto archive = openArchiveRead("/backups", "myarchive", "dar");
// Extract to a specific directory
extractArchive(archive, "/home/user/restored");
// Extract with custom read options (e.g., encrypted archive)
auto ro = ReadOptions.create();
ro.setPassword("secret");
auto encArchive = openArchiveRead("/backups", "secure", "dar", ro);
extractArchive(encArchive, "/home/user/decrypted");