Compartir a través de


ISCardVerify::Unblock method

[The Unblock 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 Unblock method re-enables the security context of the smart card.

Syntax

HRESULT Unblock(
  [in] LONG        lData,
  [in] SCARD_FLAGS Flags,
  [in] LONG        lRef
);

Parameters

lData [in]

Contains vendor-specific data to be used in the unblocking process.

Flags [in]

Indicates whether the code is global or local.

SC_FL_IHV_GLOBAL

SC_FL_IHV_LOCAL

lRef [in]

Smart card specific reference.

Return value

The Unblock method returns one of the following values:

Return code Description
S_OK

Operation completed successfully.

E_INVALIDARG

Invalid parameter.

E_POINTER

A bad pointer was passed in.

E_OUTOFMEMORY

Out of memory.

 

Remarks

To globally reset the security context, call ResetSecurityState.

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

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

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

Header

Mbnapi.h

See also

ISCardVerify

ResetSecurityState