ISCardManage::SCardUnlock

The SCardUnlock method releases exclusive use of the connected smart card.

HRESULT SCardUnlock(
  SCARD_DISPOSITIONS Disposition  
);

Parameters

Disposition [in, defaultvalue(LEAVE)]
The state to leave the smart card in when the lock is released. Possible values are LEAVE, RESET, UNPOWER, and EJECT.

Return Values

The possible return values are the following:

Value Meaning
S_OK Operation completed successfully.
E_INVALIDARG Disposition is invalid.

Remarks

To lock the connected smart card, call SCardLock.

For a list of all the methods defined by the ISCardManage interface, see ISCardManage.

In addition to the COM error codes listed above, this interface may return a smart card error code if a smart card function was called to complete the request. For information on smart card error codes, see Smart Card Error Codes.

QuickInfo

  Windows NT: Use version 4.0 SP3 and later.
  Windows: Use Windows 95 OSR2.1.
  Windows CE: Unsupported.
  Header: Declared in scardcom.h.
  Import Library: scardcom.tlb (vendor-supplied).

See Also

ISCardManage, SCardLock