Approves a FIM CM request.
Namespace: Microsoft.Clm.Provision
Assembly: Microsoft.Clm.Provision (in microsoft.clm.provision.dll)

Usage

Visual Basic
Dim request As Request
Dim dataCollection As DataCollection
Dim comment As String
Dim returnValue As Request

returnValue = RequestOperations.Approve(request, dataCollection, comment)

Syntax

Visual Basic
Public Shared Function Approve ( _
		request As Request, _
		dataCollection As DataCollection, _
		comment As String _
) As Request
C#
public static Request Approve (
		Request request,
		DataCollection dataCollection,
		string comment
)
C++
public:
static Request^ Approve (
		Request^ request, 
		DataCollection^ dataCollection, 
		String^ comment
)
J#
public static Request Approve (
		Request request, 
		DataCollection dataCollection, 
		String comment
)
JScript
public static function Approve (
		request : Request, 
		dataCollection : DataCollection, 
		comment : String
) : Request

Parameters

request

A Request object that describes the FIM CM request to be approved. The status of the FIM CM request must be Pending.

dataCollection

A DataCollection object that contains manager DataCollectionItem objects. The DataCollectionItem objects will be merged together with the existing collection of DataCollectionItem objects in the Request object. 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.

Return Value

The Request object after it has been approved by the current user. The status of the FIM CM request is set to Approved if this was the last approval required for the request; otherwise, the status remains Pending.

Remarks

The following permissions are checked when this method is called:

  • The current user must have Read permissions on the profile template.

  • The current user must be listed as an Approver in the profile template policy settings.

Multiple approvals of a FIM CM request by the same user are not permitted.


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

See Also