ICardInitialization.Initialize Method

Article
10/02/2012

Initializes the smart card initialization provider.

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

Usage

'Usage
Dim instance As ICardInitialization
Dim configData As String
Dim defaultAdminKeyData As String

instance.Initialize(configData, defaultAdminKeyData)

Syntax

'Declaration
Sub Initialize ( _
    configData As String, _
    defaultAdminKeyData As String _
)

void Initialize (
    string configData,
    string defaultAdminKeyData
)

void Initialize (
    String^ configData, 
    String^ defaultAdminKeyData
)

void Initialize (
    String configData, 
    String defaultAdminKeyData
)

function Initialize (
    configData : String, 
    defaultAdminKeyData : String
)

Parameters

configData
A String object that contains the configuration data for the provider.

defaultAdminKeyData
A String object that contains the configuration data for the default admin key. This may be a hexadecimal-encoded 3DES key.

Remarks

This method should be called before any other method is called. Any subsequent calls to this method should be ignored.

The configuration data comes from the CardInitializationData property of the SmartcardConfig member of the profile template.

Note to implementers: the initialization will typically need to perform steps such as the following: format the card, set a cardID if one is not present, create space for PIN History cache, set the adminKey or the card, and so on. The method should also perform operations defined in the BaseCSP spec to ready the card.

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