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