Previous Topic: FindComputerNext Topic: FindUserProfile


FindUserAccount

The FindUserAccount method finds a user account given its name.

Parameters

xsd:string sessionId (m)

The session identifier.

xsd:string userAccountName (m)

The user account name to search for. This may contain wildcard characters (*).

Xsd:long noOfUserAccounts

The number of user accounts that should be returned from the search if more than 1 match is found.

UserAccountPropertiesRequired userAccountPropertiesRequired

This parameter specifies which user account properties to retrieve. Mandatory if noOfUserAccounts is greater than 0.

Return Values

ArrayOfUserAccountProperties FindUserAccountReturn

An array of user account properties structures, one for each account matched by the search. This array will either be of the size of the number of accounts matched by the search, or of the number of accounts requested by the method call - whichever size is the lowest.

xsd:long totalNoOfUserAccountsFound

The total number of user accounts that were matched by the search (this can be used to indicate whether there were more matches found than the requested number of user accounts).

Remarks

The method supports wildcard pattern matching for the user account name. The name is case insensitive.

More information:

UserAccountProperties

UserAccountPropertiesRequired