ICardInitialization.GetCardChallengeResponse Method

Article
10/02/2012

Computes the cryptographic response to a smart card's challenge.

Namespace: Microsoft.Clm
Assembly: Microsoft.Clm.Common (in Microsoft.Clm.Common.dll)

Usage

'Usage
Dim instance As ICardInitialization
Dim card As ICardContext
Dim challenge As Byte()
Dim useDiversifiedKey As Boolean
Dim returnValue As Byte()

returnValue = instance.GetCardChallengeResponse(card, challenge, useDiversifiedKey)

Syntax

'Declaration
Function GetCardChallengeResponse ( _
    card As ICardContext, _
    challenge As Byte(), _
    useDiversifiedKey As Boolean _
) As Byte()

byte[] GetCardChallengeResponse (
    ICardContext card,
    byte[] challenge,
    bool useDiversifiedKey
)

array<unsigned char>^ GetCardChallengeResponse (
    ICardContext^ card, 
    array<unsigned char>^ challenge, 
    bool useDiversifiedKey
)

byte[] GetCardChallengeResponse (
    ICardContext card, 
    byte[] challenge, 
    boolean useDiversifiedKey
)

function GetCardChallengeResponse (
    card : ICardContext, 
    challenge : byte[], 
    useDiversifiedKey : boolean
) : byte[]

Parameters

card
An ICardContext object that describes the context for the smart card, which includes the card's unique identifier and its answer-to-reset (ATR) string.

challenge
An array of bytes that contains the smart card's challenge.

useDiversifiedKey
true to use the diversified admin key for the calculation; false to use the default admin key for the calculation.

Return Value

An array of bytes that contains the response to the smart card's challenge. See BaseCSP specification to learn how to create Response for a given card Challenge.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows 2008 x64 Edition

Target Platforms

Windows XP SP3, Windows Vista SP1+, Windows 7, Windows Server 2008, Windows Server 2008 R2

Share via