SmartCardContextMBS.Cancel

The only requests that you can cancel are those that require waiting for external action by the smart card or user. Any such outstanding action requests will terminate with a status indication that the action was canceled. This is especially useful to force outstanding GetStatusChange calls to terminate.

Lasterror is set.

SmartCardContextMBS.Connect(reader as string, ShareMode as UInt32, PreferredProtocols as UInt32) as SmartCardMBS

dim c as new SmartCardContextMBS

dim s as SmartCardMBS
s = c.Connect("MyReader", SmartCardMBS.kShareShared, SmartCardMBS.kProtocolAny)
if s <> nil then
  MsgBox "Connected"
else
  MsgBox "Error: "+str(c.Lasterror)
end if

Establishes a connection (using a specific resource manager context) between the calling application and a smart card contained by a specific reader. If no card exists in the specified reader, an error is returned.

Reader: The name of the reader that contains the target card.
ShareMode: A flag that indicates whether other applications may form connections to the card. Use one of SmartCardMBS.kShare* constants. e.g. kShareExclusive
PreferredProtocols: A bitmask of acceptable protocols for the connection. Possible values may be combined with the OR operation. Use SmartCardMBS.kProtocol* constants. e.g. kProtocolT1

Lasterror and ActiveProtocol are set.
Returns on success a smartcard object, else returns nil.

SmartCardContextMBS.Constructor

SmartCardContextMBS.IsValid as boolean

Returns true if valid or false if not valid.

SmartCardContextMBS.ReaderGroups as string()

The groups may be SCard$AllReaders, SCard$DefaultReaders, SCard$LocalReaders and SCard$SystemReaders.
Lasterror is set.

Some examples using this method:

• /Tools/SmartCard/SmartCard

SmartCardContextMBS.Readers as string()

dim c as new SmartCardContextMBS
dim list() as string = c.Readers
MsgBox Join(list, EndOfLine)

Lasterror is set.

See also:

• Readers(ReaderGroups() as string) as string()

Some examples using this method:

• /Tools/SmartCard/SmartCard

SmartCardContextMBS.Readers(ReaderGroups() as string) as string()

The caller supplies a list of reader groups, and receives the list of readers within the named groups. Unrecognized group names are ignored. This function only returns readers within the named groups that are currently attached to the system and available for use.

ReaderGroups: The reader groups you like to query.
Lasterror is set.

See also:

• Readers as string()