Share via


CLMUtils.CreateRecoverRequest Method

The CreateRecoverRequest(ConnectedMA, Guid, String) method creates a recover request in CLM.

Syntax

public void CreateRecoverRequest(
  ConnectedMA targetCLMMA,
  Guid aDObjectGuid,
  String profileTemplateName
);
Public Sub CreateRecoverRequest( _
  ByVal targetCLMMA As ConnectedMA, _
  ByVal aDObjectGuid As Guid, _
  ByVal profileTemplateName As String _
)

Parameters

  • targetCLMMA
    The CLM management agent through which the new object is provisioned.

  • aDObjectGuid
    The objectGuid of the associated Active Directory account for which you will create the request. This will need to be imported to the metaverse through the Active Directory management agent.

  • profileTemplateName
    The name of the profile template to which you are trying to provision the request.

Return Value

This method does not return a value.

Exceptions

Exception type Condition
ArgumentException

A required parameter is not present.

ArgumentNullException

A required parameter is null.

AttributeNotInInclusionListException

A required attribute is not selected in the management agent.

NoSuchObjectTypeException

The object type referenced is not in the schema.

UnexpectedDataException

There was an unexpected error, possibly because the request type was not valid.

Remarks

This method implements the following logic:

  • Checks to ensure that there is at least one connected profile, otherwise it throws an UnexpectedDataException.

  • Checks to ensure that the profile is in one of the following states that can support the recover request:

    • Assigned
    • Active
    • Disabled
  • Checks the connector space of the CLM MA and determines if there are any connected pending requests of the same profile template type that have been already submitted by the specified service account. If so, then it does not re-provision the request and throws an UnexpectedDataException.

  • Otherwise it provisions a new recover request into the connector space for that object.

Requirements

Product Microsoft Identity Integration Server 2003 SP2
Namespace CLMUtils
Assembly CLMUtils
.NET Framework .NET Framework 3.0

See Also

CLMUtils

Send comments about this topic to Microsoft

Build date: 2/16/2009