RequestOperations.InitiateRecover Method (Smartcard, DataCollection, String, Byte)

Article
10/02/2012

Creates a new FIM CM recover request for a smart card.

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

Usage

'Usage
Dim oldSmartcard As Smartcard
Dim dataCollection As DataCollection
Dim comment As String
Dim priority As Byte
Dim returnValue As Request

returnValue = RequestOperations.InitiateRecover(oldSmartcard, dataCollection, comment, priority)

Syntax

'Declaration
Public Shared Function InitiateRecover ( _
    oldSmartcard As Smartcard, _
    dataCollection As DataCollection, _
    comment As String, _
    priority As Byte _
) As Request

public static Request InitiateRecover (
    Smartcard oldSmartcard,
    DataCollection dataCollection,
    string comment,
    byte priority
)

public:
static Request^ InitiateRecover (
    Smartcard^ oldSmartcard, 
    DataCollection^ dataCollection, 
    String^ comment, 
    unsigned char priority
)

public static Request InitiateRecover (
    Smartcard oldSmartcard, 
    DataCollection dataCollection, 
    String comment, 
    byte priority
)

public static function InitiateRecover (
    oldSmartcard : Smartcard, 
    dataCollection : DataCollection, 
    comment : String, 
    priority : byte
) : Request

Parameters

oldSmartcard
A Smartcard object that describes the smart card to be recovered.

dataCollection
A DataCollection object that contains all manager DataCollectionItem objects. This parameter must not be Null.

comment
A String object that contains a comment to be included in the history of the FIM CM request. Set this parameter to Null for no comment.

priority
The priority of the FIM CM request.

Return Value

A Request object for the new FIM CM recover request.

Remarks

The following permissions are checked when this method is called:

The current user must have FIM CM Request Recover permissions on the target user.
The current user must have Read permissions on the profile template.
The current user must be a FIM CM manager with Read and FIM CM Request Recover permissions on the service connection point.
The current user must be listed as an Initiator on the Recover policy.

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