Export (0) Print
Expand All

CreateAccount

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Creates a new Live Meeting account.

public Status CreateAccount(string windowsId,
                         out string lmUserId,
                         out string name,
                         out string role,
                         out string password,
                         out string welcomePageUrl)

windowsId

Specifies the Windows identity of the user whose Live Meeting account password should be created.

lmUserId

Returns the user's Live Meeting user ID.

name

Returns the user's Live Meeting name.

role

Returns the user's Live Meeting role: Administrator, Organizer, or Member.

password

Returns the user's Live Meeting password.

welcomePageUrl

Returns the welcomePageUrl appropriate to the user's role.

Status

Meaning

HasAccount_Entitled

The account was not created because the user already has a Live Meeting account.

HasAccount_NotEntitled

The account was not created because the user is not entitled to have a Live Meeting account based on the users Active Directory group membership.

NoAccount_NotEntitled

The account was not created because the user is not entitled to have a Live Meeting account based on that users Active Directory group membership.

NotInDirectory

The account was not created. See the section Web Method Call Return Values above for details.

Success

The account was created.

Unauthorized

The account was not created. See the section Web Method Call Return Values above for details.

WebMethodCallsDisabled

The account was not created. See the section Web Method Call Return Values above for details.

You can issue Live Meeting accounts to new users when they first join the organization just as you issue these users Windows and e-mail accounts. This is especially important for organizations that protect meetings with an access control list (ACL) because the new user cannot be invited to an ACL-protected meeting until a Live Meeting account has been issued.

The CreateAccount Web method functions as follows:

  1. The caller invokes the Web method specifying the Windows identity of the user for whom the Live Meeting account is to be created.

  2. IIS authenticates the caller using integrated Windows authentication.

  3. The Portal does the following:

    • Verifies that Web method calls are enabled. If not, it returns WebMethodCallsDisabled.

    • Verifies that the caller is a member of a Windows security group listed in Web method callers. If not, it returns Unauthorized.

    • Calls Active Directory to retrieve the attributes for the user whose windowsId was specified in the call. If the user cannot be found in Active Directory, it returns NotInDirectory.

    • Calls the Live Meeting GetUser XML API to retrieve the users Live Meeting account information. If the user already has an account or is not entitled to have an account, it returns HasAccount_Entitled, HasAccount_NotEntitled, or NoAccount_NotEntitled, as appropriate.

    • Generates a random Live Meeting account password for the new account.

    • Calls the CreateUserXML API to the new Live Meeting account.

    • Returns Success if the CreateUser XML API call is successful; otherwise, it returns the XML API error to the caller.

LMWebService lmWebService = new LMWebService();
lmWebService.Url = "https://localhost/LMPortal/LMWebService.asmx";
lmWebService.Credentials = CredentialCache.DefaultCredentials;

string lmUserId;
string name;
string role;
string password;
string welcomePageUrl;
string windowsId = @"contoso\bill";

Status outcome = lmWebService.CreateAccount(windowsId, out lmUserId, out name, out role, out password, out welcomePageUrl);
if (outcome == Status.Success)
{
   Console.WriteLine("Account created for user " + windowsId);
   Console.WriteLine("lmUserId: " + lmUserId);
   Console.WriteLine("name: " + name);
   Console.WriteLine("role: " + role);
   Console.WriteLine("password: " + password);
   Console.WriteLine("welcomePageUrl: " + welcomePageUrl);
}
else
{
   Console.WriteLine("Account not created for user " + windowsId +
                     " due to error " + outcome);
}
Show:
© 2014 Microsoft