IOCTL_SMARTCARD_GET_STATE (Windows Embedded CE 6.0)

1/6/2010

This code retrieves the current status of the smart card reader.

Parameters

• dwOpenData
  [in] Handle returned from a call to the smart card reader driver's XXX_Open (Device Manager) function.

• dwCode
  [in] Specifies this code.

• pBufIn
  Ignored.

• dwLenIn
  Ignored.

• pBufOut
  [out] A buffer to hold the status information, one of the following values.

  Status	Description
  SCARD_UNKNOWN	Status is unknown.
  SCARD_ABSENT	There is no card in the card reader.
  SCARD_PRESENT	A card is present in the card reader, but it is not in position for use.
  SCARD_SWALLOWED	A card is in the reader and in position for use. The card is not powered.
  SCARD_POWERED	The card is powered but the reader cannot determine its mode.
  SCARD_NEGOTIABLE	The card has been reset and is waiting for protocol negotiation.
  SCARD_SPECIFIC	The card has been reset and a protocol has been negotiated.

• dwLenOut
  [out] Must be sizeof(ULONG).

• pdwActualOut
  [out] Must be sizeof(ULONG).

Return Values

The status value STATUS_SUCCESS.

Remarks

Smart card reader drivers return Windows NT status values, rather than Win32 error values, as the return values from the driver's callback function.

Requirements

See Also

Reference

Smart Card Driver IOCTLs
XXX_Open (Device Manager)