Struct pcsc::CardStatusOwned
source · pub struct CardStatusOwned { /* private fields */ }
Expand description
Status of a card in a card reader (owned).
This is an owned version of CardStatus
.
Implementations§
source§impl CardStatusOwned
impl CardStatusOwned
sourcepub fn reader_names(&self) -> &[CString]
pub fn reader_names(&self) -> &[CString]
Slice of the names by which the connected card reader is known.
Examples found in repository?
examples/connect-owned.rs (line 28)
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 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86
fn main() {
// Get a context.
let ctx = Context::establish(Scope::User).expect("failed to establish context");
// List connected readers.
let readers = ctx.list_readers_owned().expect("failed to list readers");
println!("Readers: {:?}", readers);
if readers.is_empty() {
return;
}
{
// Try to connect to a card in the first reader.
let mut card = ctx
.connect(&readers[0], ShareMode::Shared, Protocols::ANY)
.expect("failed to connect to card");
{
// Start an exclusive transaction (not required -- can work on card directly).
let tx = card.transaction().expect("failed to begin card transaction");
// Get the card status.
let status = tx.status2_owned().expect("failed to get card status");
println!("Reader names from status: {:?}", status.reader_names());
if let Some(protocol) = status.protocol2() {
println!("Protocol from status: {:?}", protocol);
} else {
println!("Protocol from status: directly connected");
}
println!("ATR from status: {:?}", status.atr());
// Send some harmless APDU to the card.
if let Some(_) = status.protocol2() {
let apdu = b"\x00\xa4\x04\x00\x08\x31\x54\x49\x43\x2e\x49\x43\x41";
let mut rapdu_buf = [0; MAX_BUFFER_SIZE];
let rapdu = tx
.transmit(apdu, &mut rapdu_buf)
.expect("failed to transmit APDU to card");
println!("RAPDU: {:?}", rapdu);
}
// Get the card's ATR.
let atr = tx
.get_attribute_owned(Attribute::AtrString)
.expect("failed to get ATR attribute");
println!("ATR from attribute: {:?}", atr);
// Get some attribute.
let ifd_version = tx
.get_attribute_owned(Attribute::VendorIfdVersion)
.expect("failed to get vendor IFD version attribute");
println!("Vendor IFD version: {:?}", ifd_version);
// Get some other attribute.
let vendor_name = tx
.get_attribute_owned(Attribute::VendorName)
.expect("failed to get vendor name attribute");
println!("Vendor name: {}", String::from_utf8(vendor_name).unwrap());
// Can either end explicity, which allows error handling,
// and setting the disposition method, or leave it to drop, which
// swallows any error and hardcodes LeaveCard.
tx.end(Disposition::LeaveCard)
.map_err(|(_, err)| err)
.expect("failed to end transaction");
}
// Can either disconnect explicity, which allows error handling,
// and setting the disposition method, or leave it to drop, which
// swallows any error and hardcodes ResetCard.
card.disconnect(Disposition::ResetCard)
.map_err(|(_, err)| err)
.expect("failed to disconnect from card");
}
// Can either release explicity, which allows error handling,
// or leave it to drop, which swallows any error.
// The function fails if there are any live clones.
ctx.release()
.map_err(|(_, err)| err)
.expect("failed to release context");
}
sourcepub fn protocol2(&self) -> Option<Protocol>
pub fn protocol2(&self) -> Option<Protocol>
Current protocol of the card, if any.
The value is meaningful only if a communication protocol has already been established.
If connected to a reader directly without an active protocol, returns None.
Examples found in repository?
examples/connect-owned.rs (line 29)
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 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86
fn main() {
// Get a context.
let ctx = Context::establish(Scope::User).expect("failed to establish context");
// List connected readers.
let readers = ctx.list_readers_owned().expect("failed to list readers");
println!("Readers: {:?}", readers);
if readers.is_empty() {
return;
}
{
// Try to connect to a card in the first reader.
let mut card = ctx
.connect(&readers[0], ShareMode::Shared, Protocols::ANY)
.expect("failed to connect to card");
{
// Start an exclusive transaction (not required -- can work on card directly).
let tx = card.transaction().expect("failed to begin card transaction");
// Get the card status.
let status = tx.status2_owned().expect("failed to get card status");
println!("Reader names from status: {:?}", status.reader_names());
if let Some(protocol) = status.protocol2() {
println!("Protocol from status: {:?}", protocol);
} else {
println!("Protocol from status: directly connected");
}
println!("ATR from status: {:?}", status.atr());
// Send some harmless APDU to the card.
if let Some(_) = status.protocol2() {
let apdu = b"\x00\xa4\x04\x00\x08\x31\x54\x49\x43\x2e\x49\x43\x41";
let mut rapdu_buf = [0; MAX_BUFFER_SIZE];
let rapdu = tx
.transmit(apdu, &mut rapdu_buf)
.expect("failed to transmit APDU to card");
println!("RAPDU: {:?}", rapdu);
}
// Get the card's ATR.
let atr = tx
.get_attribute_owned(Attribute::AtrString)
.expect("failed to get ATR attribute");
println!("ATR from attribute: {:?}", atr);
// Get some attribute.
let ifd_version = tx
.get_attribute_owned(Attribute::VendorIfdVersion)
.expect("failed to get vendor IFD version attribute");
println!("Vendor IFD version: {:?}", ifd_version);
// Get some other attribute.
let vendor_name = tx
.get_attribute_owned(Attribute::VendorName)
.expect("failed to get vendor name attribute");
println!("Vendor name: {}", String::from_utf8(vendor_name).unwrap());
// Can either end explicity, which allows error handling,
// and setting the disposition method, or leave it to drop, which
// swallows any error and hardcodes LeaveCard.
tx.end(Disposition::LeaveCard)
.map_err(|(_, err)| err)
.expect("failed to end transaction");
}
// Can either disconnect explicity, which allows error handling,
// and setting the disposition method, or leave it to drop, which
// swallows any error and hardcodes ResetCard.
card.disconnect(Disposition::ResetCard)
.map_err(|(_, err)| err)
.expect("failed to disconnect from card");
}
// Can either release explicity, which allows error handling,
// or leave it to drop, which swallows any error.
// The function fails if there are any live clones.
ctx.release()
.map_err(|(_, err)| err)
.expect("failed to release context");
}
sourcepub fn protocol(&self) -> Protocol
pub fn protocol(&self) -> Protocol
Current protocol of the card, if any.
The value is meaningful only if a communication protocol has already been established.
Panics
This function panics when connected to a reader directly without an
active protocol. Use protocol2()
instead if you want to avoid this.
sourcepub fn atr(&self) -> &[u8] ⓘ
pub fn atr(&self) -> &[u8] ⓘ
The current ATR string of the card.
Examples found in repository?
examples/connect-owned.rs (line 34)
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 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86
fn main() {
// Get a context.
let ctx = Context::establish(Scope::User).expect("failed to establish context");
// List connected readers.
let readers = ctx.list_readers_owned().expect("failed to list readers");
println!("Readers: {:?}", readers);
if readers.is_empty() {
return;
}
{
// Try to connect to a card in the first reader.
let mut card = ctx
.connect(&readers[0], ShareMode::Shared, Protocols::ANY)
.expect("failed to connect to card");
{
// Start an exclusive transaction (not required -- can work on card directly).
let tx = card.transaction().expect("failed to begin card transaction");
// Get the card status.
let status = tx.status2_owned().expect("failed to get card status");
println!("Reader names from status: {:?}", status.reader_names());
if let Some(protocol) = status.protocol2() {
println!("Protocol from status: {:?}", protocol);
} else {
println!("Protocol from status: directly connected");
}
println!("ATR from status: {:?}", status.atr());
// Send some harmless APDU to the card.
if let Some(_) = status.protocol2() {
let apdu = b"\x00\xa4\x04\x00\x08\x31\x54\x49\x43\x2e\x49\x43\x41";
let mut rapdu_buf = [0; MAX_BUFFER_SIZE];
let rapdu = tx
.transmit(apdu, &mut rapdu_buf)
.expect("failed to transmit APDU to card");
println!("RAPDU: {:?}", rapdu);
}
// Get the card's ATR.
let atr = tx
.get_attribute_owned(Attribute::AtrString)
.expect("failed to get ATR attribute");
println!("ATR from attribute: {:?}", atr);
// Get some attribute.
let ifd_version = tx
.get_attribute_owned(Attribute::VendorIfdVersion)
.expect("failed to get vendor IFD version attribute");
println!("Vendor IFD version: {:?}", ifd_version);
// Get some other attribute.
let vendor_name = tx
.get_attribute_owned(Attribute::VendorName)
.expect("failed to get vendor name attribute");
println!("Vendor name: {}", String::from_utf8(vendor_name).unwrap());
// Can either end explicity, which allows error handling,
// and setting the disposition method, or leave it to drop, which
// swallows any error and hardcodes LeaveCard.
tx.end(Disposition::LeaveCard)
.map_err(|(_, err)| err)
.expect("failed to end transaction");
}
// Can either disconnect explicity, which allows error handling,
// and setting the disposition method, or leave it to drop, which
// swallows any error and hardcodes ResetCard.
card.disconnect(Disposition::ResetCard)
.map_err(|(_, err)| err)
.expect("failed to disconnect from card");
}
// Can either release explicity, which allows error handling,
// or leave it to drop, which swallows any error.
// The function fails if there are any live clones.
ctx.release()
.map_err(|(_, err)| err)
.expect("failed to release context");
}
Trait Implementations§
source§impl Clone for CardStatusOwned
impl Clone for CardStatusOwned
source§fn clone(&self) -> CardStatusOwned
fn clone(&self) -> CardStatusOwned
Returns a copy of the value. Read more
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source
. Read moreAuto Trait Implementations§
impl RefUnwindSafe for CardStatusOwned
impl Send for CardStatusOwned
impl Sync for CardStatusOwned
impl Unpin for CardStatusOwned
impl UnwindSafe for CardStatusOwned
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more