ExecuteOperations.Recover Method

Article
10/02/2012

Perform the recover operation for a smart card or a software based profile.

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

Usage

'Usage
Dim requestUuid As Guid
Dim certificateRequest As ReadOnlyCollection(Of CertificateRequest)
Dim pfxPassword As String
Dim comment As String
Dim returnValue As ReadOnlyCollection(Of Certificate)

returnValue = ExecuteOperations.Recover(requestUuid, certificateRequest, pfxPassword, comment)

Syntax

'Declaration
Public Shared Function Recover ( _
    requestUuid As Guid, _
    certificateRequest As ReadOnlyCollection(Of CertificateRequest), _
    pfxPassword As String, _
    comment As String _
) As ReadOnlyCollection(Of Certificate)

public static ReadOnlyCollection<Certificate> Recover (
    Guid requestUuid,
    ReadOnlyCollection<CertificateRequest> certificateRequest,
    string pfxPassword,
    string comment
)

public:
static ReadOnlyCollection<Certificate^>^ Recover (
    Guid requestUuid, 
    ReadOnlyCollection<CertificateRequest^>^ certificateRequest, 
    String^ pfxPassword, 
    String^ comment
)

public static ReadOnlyCollection<Certificate> Recover (
    Guid requestUuid, 
    ReadOnlyCollection<CertificateRequest> certificateRequest, 
    String pfxPassword, 
    String comment
)

public static function Recover (
    requestUuid : Guid, 
    certificateRequest : ReadOnlyCollection<CertificateRequest>, 
    pfxPassword : String, 
    comment : String
) : ReadOnlyCollection<Certificate>

Parameters

requestUuid
A Guid object that identifies the FIM CM request for which to perform the recover operation.

certificateRequest
A read-only collection of CertificateRequest objects that are required to perform the recover operation.

pfxPassword
A String object that contains a password to protect any Personal Information Exchange (PFX) results that are returned from the call.

comment
A String object that contains a comment to be recorded in the event history for the recover operation.

Return Value

A read-only collection of Certificate objects that resulted from the recover operation.

Remarks

PFX format, also known as PKCS#12, is used to retrieve certificates that are archived at the certification authority (CA), certificates generated on the server, or external certificates that are obtained during recovery. The Certificate object supports many formats that represent the certificate information, such as PKCS#7, PFX. This call requires the caller to perform the interaction with the smart card to write the returned certificate and possibly key data.

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