PosExplorer Class

2/27/2008

PosExplorer provides Point of Service (POS) applications with a single entry point to POS for .NET services. PosExplorer supports applications by:

• Enumerating installed POS devices.
• Instantiating Service Objects.
• Receiving Plug and Play events when a POS peripheral device is connected or disconnected.

PosExplorer Properties

The following table describes PosExplorer properties.

PosExplorer Methods

The following table describes PosExplorer methods.

PosExplorer Events

The following table describes PosExplorer events.

Example

The following code example demonstrates how to create an instance of PosExplorer, connect to Plug and Play events, and use it to identify all connected Magnetic Stripe Reader (MSR) devices. The code example prints information about the MSR to the console and closes the device after it has finished.

// Creates a new instance of an MSR.
void CreateMsr(DeviceInfo msrinfo)
{
   msr = (Msr)explorer.CreateInstance(msrinfo);
   msr.Open();
   msr.Claim(1000);
   msr.DeviceEnabled = true;
}

static void Main(string[] args)
{

   // Create a new instance of PosExplorer and use it to 
   // collect device information.
   PosExplorer explorer = new PosExplorer();
   DeviceCollection devices = explorer.GetDevices();

   // Search all connected devices for an MSR, print its service 
   // object name to the console, and close it when finished.
   foreach (DeviceInfo device in devices)
   {   
      if (device.Type == DeviceType.Msr)
      {
         if (device.ServiceObjectName == currentMsr)
         {
            CreateMsr(device);
            Console.WriteLine(device.ServiceObjectName);

            // It is important that applications close all open
            // Service Objects before terminating.
            msr.Close();
            msr = null;
         }
      }
   }
}  

See Also

Concepts

POS for .NET Integration with Plug and Play

Other Resources

POS for .NET API Support
Developing Service Objects Using Base Classes