XblMultiplayerManagerLobbySessionInviteFriends
標準の Xbox UI を表示し、ユーザーが友達や最近のプレーヤーを選択してゲームに招待できるようにします。
構文
HRESULT XblMultiplayerManagerLobbySessionInviteFriends(
XblUserHandle requestingUser,
const char* contextStringId,
const char* customActivationContext
)
パラメーター
requestingUser _In_
型: XblUserHandle
招待を送信するユーザー。
contextStringId _In_opt_z_
型: char*
省略可能。 標準の招待テキストに追加されるカスタム招待テキストを識別するための、Xbox Live の取り込み中に定義される文字列であるカスタム コンテキスト文字列 ID。 ID 文字列の前には 3 つのスラッシュ文字 ("///") を付ける必要があります。
customActivationContext _In_opt_z_
型: char*
省略可能。 招待されたゲーム クライアントに渡され、ゲームの必要に応じて解釈されるゲーム定義の文字列である、アクティベーション コンテキスト文字列。
戻り値
型: HRESULT
この API 操作の HRESULT 結果コード。
解説
この機能が呼び出されると、ユーザーが標準の Xbox UI でプレーヤーの選択を確認すると、Multiplayer Manager は選択されたプレーヤーに招待を送信します。 選択したプレイヤーが招待を受け入れると、タイトルが通知されます。 GDK ベースのゲームの場合、XGameInviteRegisterForEvent 関数が呼び出されたときに指定されたコールバック関数を呼び出すことにより、タイトルが通知されます。 他のプラットフォームに基づくゲームの場合、タイトルがアクティブになります。 詳細については、「招待を受け取る」を参照してください。
要件
ヘッダー: multiplayer_manager_c.h
ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib
関連項目
multiplayer_manager_c
XblMultiplayerManagerJoinLobby
XblMultiplayerManagerLobbySessionAddLocalUser
XblMultiplayerManagerLobbySessionInviteUsers