RequestOperations.CreateSmartcard Method (String, String, String, Request)

Article
10/02/2012

Registers a new smart card.

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

Usage

'Usage
Dim serialNumber As String
Dim middleware As String
Dim atr As String
Dim request As Request
Dim returnValue As Smartcard

returnValue = RequestOperations.CreateSmartcard(serialNumber, middleware, atr, request)

Syntax

'Declaration
Public Shared Function CreateSmartcard ( _
    serialNumber As String, _
    middleware As String, _
    atr As String, _
    request As Request _
) As Smartcard

public static Smartcard CreateSmartcard (
    string serialNumber,
    string middleware,
    string atr,
    Request request
)

public:
static Smartcard^ CreateSmartcard (
    String^ serialNumber, 
    String^ middleware, 
    String^ atr, 
    Request^ request
)

public static Smartcard CreateSmartcard (
    String serialNumber, 
    String middleware, 
    String atr, 
    Request request
)

public static function CreateSmartcard (
    serialNumber : String, 
    middleware : String, 
    atr : String, 
    request : Request
) : Smartcard

Parameters

serialNumber
A String object that contains the serial number of the new smart card.

middleware
A String object that contains the middleware for the new smart card.

atr
A String object that contains the smart card answer-to-reset (ATR) string for the new smart card.

request
A Request object that describes the FIM CM request with which to bind the smart card. The status of the FIM CM request must be Approved or Executing.

Return Value

A Smartcard object for the new smart card.

Remarks

For the middleware parameter, the following middlewares are currently defined and supported by FIM CM:

Type of middleware	String to pass in middleware parameter
AET SafeSign Identity Client	A.E.T. Europe B.V.
Aladdin eToken Runtime Environment	Aladdin Knowledge Systems Ltd.
Axalto Access Client Software	Axalto
Gemplus GemSafe	Gemplus
Microsoft Base CSP	MSBaseCSP
Siemens HiPath SIcurity Card API	Siemens AG (C)

FIM CM, by using the smart card client, interacts with smart cards by using one of the supported middlewares. Therefore, if you want to use the support for FIM CM request execution that is built into FIM CM, you must to use one of the supported middleware types in the previous list. However, if you implement your own support for smart card interaction and FIM CM request execution, you can specify any middleware.

When using PKCS#11-based middleware, the string to pass in the middleware parameter is extracted from the manufacturerID member of the CK_SLOT_INFO structure defined in PKCS#11.

The following permissions are checked when this method is called:

The current user must have Execute permissions on the FIM CM request.

The status of the FIM CM request will be set to Executing.

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