Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

GetTicket

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.

Retrieves a login ticket. The caller must be running under the Windows identity of the Live Meeting user for whom the ticket is retrieved.

The GetTicket Web method is different from the other methods because it is always called under the identity of the Windows user who is requesting the login ticket. Any Windows user can call the GetTicket Web method. Only users who have a Live Meeting account and who are authorized to use Live Meeting based on their Active Directory group membership are issued a login ticket.

public Status GetTicket(out string lmUserId,
                        out string name, 
                        out string role, 
                        out string ticketURL,
                        out int ticketTimeout)

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.

ticket

Returns the login ticket.

ticketTimeout

Returns the timeout interval for the login ticket.

Status

Meaning

HasAccount_NotEntitled

The login ticket was not issued because the Windows user who is specified in the call has a Live Meeting account but is no longer entitled to have it based on that user's current Active Directory group membership.

LoginDisabled

The login ticket was not issued because the Portal administrator has disabled Live Meeting Login.

NoAccount_Entitled

The login ticket was not issued because no Live Meeting account was found for the user, although the user is entitled to have a Live Meeting account.

NoAccount_NotEntitled

The login ticket was not issued because no Live Meeting account was found for the user, and the user is not entitled to have a Live Meeting account.

NotInDirectory

The login ticket was not issued. See the section Web Method Call Return Values above for details.

Success

The login ticket was issued.

The GetTicket Web method functions as follows:

  1. The caller invokes the Web method. The caller must be running under the Windows identity of the user for whom the Live Meeting login ticket is to be obtained.

  2. IIS authenticates the caller using integrated Windows authentication.

  3. The Portal does the following:

    • Verifies that the caller is Windows-authenticated.

    • Verifies that login is enabled. If not, it returns LoginDisabled.

    • Calls Active Directory to retrieve the attributes for the caller. If the caller cannot be found in Active Directory, it returns NotInDirectory.

    • Calls the Live Meeting GetUser XML API to retrieve the callers Live Meeting account information. If the caller 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 CreateTicket XML API to obtain a login ticket.

    • Returns Success if the CreateTicket XML API call is successful along with the lmUserId, name, role, and ticket. 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 ticketURL;
int ticketTimeout;

Status outcome = lmWebService.GetTicket(out lmUserId, out name, out role,
                                        out ticketURL, out ticketTimeout);
if (outcome == Status.Success)
{
   Console.WriteLine("Ticket obtained for user: ");
   Console.WriteLine("lmUserId: " + lmUserId);
   Console.WriteLine("name: " + name);
   Console.WriteLine("role: " + role);
   Console.WriteLine("ticketURL: " + ticketURL);
   Console.WriteLine("ticketTimeout: " + ticketTimeout);
}
else
{
   Console.WriteLine("Ticket not obtained for user " + windowsId +
                     " due to error " + outcome);
}
Show:
© 2015 Microsoft