Edit

ISCardAuth::ICC_Auth method

  • Article

[The ICC_Auth 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 ICC_Auth method allows an application to authenticate the smart card.

Syntax

HRESULT ICC_Auth(
  [in]      LONG         lAlgoID,
  [in]      LPBYTEBUFFER pParam,
  [in, out] LPBYTEBUFFER *pBuffer
);

Parameters

lAlgoID [in]

Algorithm to be used in the authentication process.

pParam [in]

An IByteBuffer object containing vendor-specific parameters of the authentication process.

pBuffer [in, out]

On input, contains data to be used in the authentication process.

On output, contains the result of the authentication process.

Return value

The method returns one of the following possible 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

For a list of all the methods provided by this interface, see ISCardAuth.

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

ISCardAuth