Registers a new smart card.
Namespace: Microsoft.Clm.Provision
Assembly: Microsoft.Clm.Provision (in microsoft.clm.provision.dll)

Usage

Visual Basic
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

Visual Basic
Public Shared Function CreateSmartcard ( _
		serialNumber As String, _
		middleware As String, _
		atr As String, _
		request As Request _
) As Smartcard
C#
public static Smartcard CreateSmartcard (
		string serialNumber,
		string middleware,
		string atr,
		Request request
)
C++
public:
static Smartcard^ CreateSmartcard (
		String^ serialNumber, 
		String^ middleware, 
		String^ atr, 
		Request^ request
)
J#
public static Smartcard CreateSmartcard (
		String serialNumber, 
		String middleware, 
		String atr, 
		Request request
)
JScript
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

See Also