SystemUI.ShowLookingForGroupResultsAsync Method

Brings up a narrow dialog (like the Profile Card) which shows up to 100 Looking For Group (LFG) results for the calling title.

Syntax

public:
static IAsyncAction^ ShowUserLookingForGroupsAsync(
    IUser^ requestingUser,
    IReadOnlyList<String^>^ tags)

Parameters

requestingUser
Type: Windows::Xbox::System::IUser^

The user initiating the action.

tags
Type: System::Collections::Generic::IReadOnlyList<System::String^>^

If tags are supplied, the results are limited to those LFG posts which match these tags. Otherwise, if no tags are supplied (that is, if the IReadOnlyList is empty), there is no filter on the results.

Return value

Type: Windows::Foundation::IAsyncAction^

Returns an IAsyncAction object that represents the state of the asynchronous operation. Completion of the asynchronous operation is signaled by using a handler that is passed to the IAsyncAction.Completed property.

Requirements

Namespace: Windows.Xbox.UI

Metadata: windows.winmd

Remarks

The results are sorted in a way that favors LFGs that have recent activity—where “activity” includes the initial creation of the LFG, and the confirming of applicants by the host.

The user may click on any of these LFG results, which will open up the LFG Detail dialog. Here the user may express interest, message the host, or perform other actions related to the LFG.

In addition to the results list, the TCUI contains two buttons:

Search all posts for this game: Navigates to the full screen Game Hub experience, on the Multiplayer tab, where the user can browse and manually filter the full list of LFG posts.
Create post: Opens the Create LFG dialog, scoped to the calling title, with any of the tags that were entered in the query preselected (though the user may edit these tags).

The strings passed into the tags parameter must obey the following rules:

Must contain only a-z, A-Z, and 0-9 characters
The first character must be in a-z or A-Z (no numbers)

Otherwise, the method will return E_INVALIDARG.