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)
Parameters
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.
Return Values
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. |
Remarks
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:
The caller invokes the Web method specifying the Windows identity of the user for whom the Live Meeting account is to be created.
IIS authenticates the caller using integrated Windows authentication.
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.
Examples
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);
}