Struct pcsc::Context[−][src]

pub struct Context { /* fields omitted */ }

Expand description

Library context to the PCSC service.

This structure wraps SCARDCONTEXT.

Implementations

[src]

impl Context

[src]

pub fn establish(scope: Scope) -> Result<Context, Error>

Establish a new context.

This function wraps SCardEstablishContext (pcsclite, MSDN).

[src]

pub fn release(self) -> Result<(), (Context, Error )>

Release the context.

In case of error, ownership of the context is returned to the caller.

This function wraps SCardReleaseContext (pcsclite, MSDN).

Note

Context implements Drop which automatically releases the context; you only need to call this function if you want to handle errors.

If the Context was cloned, and a clone is still alive, this function will fail with Error::CantDispose.

[src]

pub fn is_valid(&self) -> Result<(), Error>

Check whether the Context is still valid.

This function wraps SCardIsValidContext (pcsclite, MSDN).

[src]

pub fn cancel(&self) -> Result<(), Error>

Cancel any ongoing blocking operation in the Context.

See the cancel.rs example program.

This function wraps SCardCancel (pcsclite, MSDN).

[src]

pub fn list_readers<'buf>(
&self,
buffer: &'buf mut [u8 ]
) -> Result<ReaderNames<'buf>, Error>

List all connected card readers.

buffer is a buffer that should be large enough to hold all of the connected reader names. The function list_readers_len can be used to find the exact required length.

Returns an iterator over the reader names. The iterator yields values directly from buffer.

If the buffer is not large enough to hold all of the names, Error::InsufficientBuffer is returned.

This function wraps SCardListReaders (pcsclite, MSDN).

[src]

pub fn list_readers_len(&self) -> Result<usize, Error>

Get the needed length of a buffer to be passed to list_readers.

This function wraps SCardListReaders (pcsclite, MSDN).

[src]

pub fn list_readers_owned(&self) -> Result<Vec<CString>, Error>

List all connected card readers, allocating buffers of the required size.

This function wraps SCardListReaders (pcsclite, MSDN). It is an owned version of list_readers, calling list_readers_len to determine the required buffer size.

[src]

pub fn connect(
 &self,
 reader: &CStr,
 share_mode: ShareMode,
 preferred_protocols: Protocols
) -> Result<Card, Error>

Connect to a card which is present in a reader.

See the connect.rs example program.

This function wraps SCardConnect (pcsclite, MSDN).

[src]

pub fn get_status_change<D>(
 &self,
 timeout: D,
 readers: &mut [ReaderState ]
) -> Result<(), Error> where
 D: Into<Option<Duration>>,

Wait for card and card reader state changes.

The function blocks until the state of one of the readers changes from corresponding passed-in ReaderState. The ReaderStates are updated to report the new state.

A special reader name, \\?PnP?\Notification, can be used to detect card reader insertions and removals, as opposed to state changes of a specific reader. Use PNP_NOTIFICATION() to easily obtain a static reference to this name.

See the monitor.rs example program.

This function wraps SCardGetStatusChange (pcsclite, MSDN).