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