2.2.3.9 State_Return

  • Article

The State_Return structure defines return information about the state of the smart card reader (for more information, see section 3.1.4.40).

 typedef struct _State_Return {
   long ReturnCode;
   unsigned long dwState;
   unsigned long dwProtocol;
   [range(0,36)] unsigned long cbAtrLen;
   [unique] [size_is(cbAtrLen)] byte *rgAtr;
 } State_Return;

ReturnCode: HRESULT or Win32 Error code. Zero indicates success; any other value indicates failure.

dwState: The current state of the smart card in the Reader. Possible values are specified in section 2.2.4.

dwProtocol: The current protocol, if any. Possible values are specified in section 2.2.5.

cbAtrLen: The number of bytes in the rgAtr field.

rgAtr: A pointer to a buffer that receives the ATR string from the currently inserted card, if available.