ISCardAuth::GetChallenge

The GetChallenge method returns a challenge from the smart card.

HRESULT GetChallenge(
  LONG lAlgoID,
  LONG lLengthOfChallenge,
  LPBYTEBUFFER pParam,
  LPBYTEBUFFER *pBuffer
);
 

Parameters

lAlgoID [in, optional]
Specifies the algorithm to be used in the authentication process.
lLengthOfChallenge [in]
Maximum length of expected response.
pParam [in]
IByteBuffer containing vendor-specific parameters of the authentication process.
pBuffer [in ,out]
On input, points to the buffer.

On output, contains the challenge data from the card.

Return Values

The possible return values are the following:

Value Meaning
S_OK Operation completed successfully.
E_INVALIDARG Invalid parameter.
E_POINTER A bad pointer was passed in.
E_OUTOFMEMORY Out of memory.

For a list of all the methods provided by the ISCardAuth 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 information on smart card error codes, see 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

ISCardAuth