RequestOperations.InitiateEnroll Method

Article
10/02/2012

Creates a new FIM CM enroll request, where the current user is the initiator.

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

Usage

'Usage
Dim profileTemplateUuid As Guid
Dim dataCollection As DataCollection
Dim targetUserUuid As Guid
Dim comment As String
Dim priority As Byte
Dim returnValue As Request

returnValue = RequestOperations.InitiateEnroll(profileTemplateUuid, dataCollection, targetUserUuid, comment, priority)

Syntax

'Declaration
Public Shared Function InitiateEnroll ( _
    profileTemplateUuid As Guid, _
    dataCollection As DataCollection, _
    targetUserUuid As Guid, _
    comment As String, _
    priority As Byte _
) As Request

public static Request InitiateEnroll (
    Guid profileTemplateUuid,
    DataCollection dataCollection,
    Guid targetUserUuid,
    string comment,
    byte priority
)

public:
static Request^ InitiateEnroll (
    Guid profileTemplateUuid, 
    DataCollection^ dataCollection, 
    Guid targetUserUuid, 
    String^ comment, 
    unsigned char priority
)

public static Request InitiateEnroll (
    Guid profileTemplateUuid, 
    DataCollection dataCollection, 
    Guid targetUserUuid, 
    String comment, 
    byte priority
)

public static function InitiateEnroll (
    profileTemplateUuid : Guid, 
    dataCollection : DataCollection, 
    targetUserUuid : Guid, 
    comment : String, 
    priority : byte
) : Request

Parameters

profileTemplateUuid
A Guid object that identifies the profile template for which to enroll.

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

targetUserUuid
A Guid object that identifies the target user.

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 enroll request.

Remarks

The following permissions are checked when this method is called:

The target user must have Enroll and Read permissions on the profile template.
The current user must have FIM CM Request Enroll 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 Enroll permissions on the service connection point.
The current user must be listed as an Initiator on the Enroll policy in the profile template.

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