FindOperations.FindSmartcards Method

Article
10/02/2012

Finds all the smart cards that match the specified criteria.

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

Usage

'Usage
Dim statuses As SmartcardStatus()
Dim serialNumbers As String()
Dim middlewares As String()
Dim assignedUsersUuid As Guid()
Dim assignedFrom As DateTime
Dim assignedTo As DateTime
Dim returnValue As ReadOnlyCollection(Of Smartcard)

returnValue = FindOperations.FindSmartcards(statuses, serialNumbers, middlewares, assignedUsersUuid, assignedFrom, assignedTo)

Syntax

'Declaration
Public Shared Function FindSmartcards ( _
    statuses As SmartcardStatus(), _
    serialNumbers As String(), _
    middlewares As String(), _
    assignedUsersUuid As Guid(), _
    assignedFrom As DateTime, _
    assignedTo As DateTime _
) As ReadOnlyCollection(Of Smartcard)

public static ReadOnlyCollection<Smartcard> FindSmartcards (
    SmartcardStatus[] statuses,
    string[] serialNumbers,
    string[] middlewares,
    Guid[] assignedUsersUuid,
    DateTime assignedFrom,
    DateTime assignedTo
)

public:
static ReadOnlyCollection<Smartcard^>^ FindSmartcards (
    array<SmartcardStatus>^ statuses, 
    array<String^>^ serialNumbers, 
    array<String^>^ middlewares, 
    array<Guid>^ assignedUsersUuid, 
    DateTime assignedFrom, 
    DateTime assignedTo
)

public static ReadOnlyCollection<Smartcard> FindSmartcards (
    SmartcardStatus[] statuses, 
    String[] serialNumbers, 
    String[] middlewares, 
    Guid[] assignedUsersUuid, 
    DateTime assignedFrom, 
    DateTime assignedTo
)

public static function FindSmartcards (
    statuses : SmartcardStatus[], 
    serialNumbers : String[], 
    middlewares : String[], 
    assignedUsersUuid : Guid[], 
    assignedFrom : DateTime, 
    assignedTo : DateTime
) : ReadOnlyCollection<Smartcard>

Parameters

statuses
An array of SmartcardStatus values that specify the statuses of the smart cards to find. Supply an empty array to find smart cards with any status value.

serialNumbers
An array of String objects that specify the serial numbers of the smart cards to find. Supply an empty array to find smart cards with any serial number.

middlewares
An array of String objects that specify the middleware for the smart cards to find. Supply an empty array to find smart cards that are associated with any middleware.

assignedUsersUuid
An array of Guid objects that specify the users assigned to the smart cards to find. Supply an empty array to find smart cards assigned to any user.

assignedFrom
A DateTime object, in Coordinated Universal Time (UTC), that specifies the time after which the smart cards to find were assigned.

assignedTo
A DateTime object, in Coordinated Universal Time (UTC), that specifies the time before which the smart cards to find were assigned.

Return Value

A read-only collection of Smartcard objects that match the specified criteria.

Remarks

The criteria that are specified in the supplied parameters are combined. All of the criteria must be satisfied for a smart card to be included in the result set. The submittedFrom and submittedToDateTime objects are used to define a time range during which the returned smart cards were assigned.

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

Middleware string	Type of middleware
"A.E.T. Europe B.V."	AET Safe Sign P11
"Aladdin Knowledge Systems Ltd."	Aladdin P11
"Axalto"	Axalto P11
"Gemplus"	Gemplus P11
"MSBaseCSP"	Microsoft Base CSP
"Siemens AG (C)"	Siemens

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