DeactivateAccount
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.
Deactivates the Live Meeting account.
public Status DeactivateAccount(string windowsId)
Parameters
windowsId
Specifies the user's Windows identity that is to be deactivated.
Return Values
Status |
Meaning |
|---|---|
NoAccount_Entitled |
The account was not deactivated because the Live Meeting account was not found for the user. |
NoAccount_NotEntitled |
The account was not deactivated because the Live Meeting account was not found for the user. |
NotInDirectory |
The account was not deactivated. See the section Web Method Call Return Values above for details. |
Success |
The account was deactivated. |
Unauthorized |
The account was not deactivated. See the section Web Method Call Return Values above for details. |
WebMethodCallsDisabled |
The account was not deactivated. See the section Web Method Call Return Values above for details. |
Remarks
You can automate Live Meeting account deletion by invoking the DeleteAccount Web method whenever a user leaves the organization. This Web method deletes the user's Live Meeting account and it deletes all information regarding meetings organized by the user.
You might want to automate the process by using the DeactivateAccount Web method to deactivate a user's Live Meeting account when they leave the organization rather than deleting the account. This has two advantages:
If the account is deactivated, you can reactivate the account later without loosing account information.
If the account is deactivated, you preserve the recordings and other meeting related data resulting from the meetings organized by the user.
The DeactivateAccount 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 deactivated.
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 user's Live Meeting account information. If the user does not have an account or is not entitled to have an account, it returns NoAccount_Entitled, NoAccount_NotEntitled, or HasAccount_NotEntitled as appropriate.
Calls the ModifyUser XML API and sets the expireTime account attribute to the current date and time. This deactivates the account.
Returns Success if the ModifyUser 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 windowsId = @"contoso\bill";
Status outcome = lmWebService.DectivateAccount(windowsId);
if (outcome == Status.Success)
{
Console.WriteLine("Account deactivated for user " + windowsId);
}
else
{
Console.WriteLine("Account not deactivated for user " + windowsId +
" due to error " + outcome);
}