Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
RetrieveAllChildUsersSystemUser Message (CrmService)
Collapse the table of content
Expand the table of content

RetrieveAllChildUsersSystemUser Message (CrmService)

banner art

[Applies to: Microsoft Dynamics CRM 4.0]

Find the latest SDK documentation: CRM 2015 SDK

Works for all deployment typesWorks online and offline

Retrieves the collection of users that report to the specified system user (user).

The relevant classes are specified in the following table.

TypeClass
RequestRetrieveAllChildUsersSystemUserRequest
ResponseRetrieveAllChildUsersSystemUserResponse
Entitysystemuser

Remarks

To use this message, pass an instance of the RetrieveAllChildUsersSystemUserRequest class as the request parameter in the Execute method.

To perform this action, the caller must have access rights on the system user (user) entity instance. For a list of required privileges, see RetrieveAllChildUsersSystemUser Privileges.

Example

The following code example shows how to use the RetrieveAllChildUsersSystemUser message.

[C#]
// Set up the CRM service.
CrmAuthenticationToken token = new CrmAuthenticationToken();
// You can use enums.cs from the SDK\Helpers folder to get the enumeration for Active Directory authentication.
token.AuthenticationType = 0; 
token.OrganizationName = "AdventureWorksCycle";
 
CrmService service = new CrmService();
service.Url = "http://<servername>:<port>/mscrmservices/2007/crmservice.asmx";
service.CrmAuthenticationTokenValue = token;
service.Credentials = System.Net.CredentialCache.DefaultCredentials;

// Create the request object.
RetrieveAllChildUsersSystemUserRequest retrieve = new RetrieveAllChildUsersSystemUserRequest();

// Create the column set object that indicates the fields to be retrieved.
ColumnSet cols = new ColumnSet();

// Set the column set properties.
cols.Attributes = new string[] { "systemuserid", "domainname" };

// Set the column set.
retrieve.ColumnSet = cols;

// Set the ID of the parent user.
retrieve.EntityId = new Guid("18ECA720-493E-4800-BBFD-638BD54EB325");

// Execute the request.
RetrieveAllChildUsersSystemUserResponse retrieved = 
    (RetrieveAllChildUsersSystemUserResponse)service.Execute(retrieve);
[Visual Basic .NET]
' Set up the CRM service.
Dim token As New CrmAuthenticationToken()
' You can use enums.cs from the SDK\Helpers folder to get the enumeration for Active Directory authentication.
token.AuthenticationType = 0
token.OrganizationName = "AdventureWorksCycle"
 
Dim service As New CrmService()
service.Url = "http://<servername>:<port>/mscrmservices/2007/crmservice.asmx"
service.CrmAuthenticationTokenValue = token
service.Credentials = System.Net.CredentialCache.DefaultCredentials

' Create the request object.
Dim retrieve As New RetrieveAllChildUsersSystemUserRequest()

' Create the column set object that indicates the fields to be retrieved.
Dim cols As New ColumnSet()

' Set the column set properties.
cols.Attributes = New String() {"systemuserid", "domainname"}

' Set the column set.
retrieve.ColumnSet = cols

' Set the ID of the parent user.
retrieve.EntityId = New Guid("18ECA720-493E-4800-BBFD-638BD54EB325")

' Execute the request.
Dim retrieved As RetrieveAllChildUsersSystemUserResponse = CType(service.Execute(retrieve), RetrieveAllChildUsersSystemUserResponse)

See Also

Concepts

Reference


© 2010 Microsoft Corporation. All rights reserved.


Show:
© 2015 Microsoft