Edit

Share via

ISCardManage::SCardUnlock method

  • Article

[The SCardUnlock method is available for use in the operating systems specified in the Requirements section. It is not available for use in Windows Server 2003 with Service Pack 1 (SP1) and later, Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The Smart Card Modules provide similar functionality.]

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

Syntax

HRESULT SCardUnlock(
  [in] SCARD_DISPOSITIONS Disposition
);

Parameters

Disposition [in]

The state to leave the smart card in when the lock is released.

LEAVE

RESET

UNPOWER

EJECT

Return value

The method returns one of the following possible values.

Return code Description
S_OK
 Operation completed successfully.
E_INVALIDARG
 The Disposition parameter is not valid.

 

Remarks

To lock the connected smart card, call SCardLock.

For a list of all the methods defined by this 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 more information, see Smart Card Return Values.

Requirements

Requirement Value
Minimum supported client
 Windows XP [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]
End of client support
 Windows XP
End of server support
 Windows Server 2003

See also

ISCardManage

SCardLock