Skip to main content

XblMultiplayerSessionGetRoleByName

ロールの種類名とロール名で XblMultiplayerRole オブジェクトを取得します。

構文

パラメーター

handle   _In_
型: XblMultiplayerSessionHandle
マルチプレイヤー セッションへのハンドル。 roleTypeName   _In_z_
型: char*
ロールが属するロールの種類の名前。 roleName   _In_z_
型: char*
ロールの名前。 role   _Out_
型: XblMultiplayerRole**
ロールに関する情報を持つロール オブジェクトへのポインターを返します。ポインターのメモリは、XblMultiplayerSessionHandle オブジェクトが閉じられるまで、そのライフタイム中は有効です。該当するロールが存在しない場合は、nullptr が返されます。

戻り値

型: HRESULT この API 操作の HRESULT 戻りコード。

解説

新しく作成されたセッションでは、XblMultiplayerWriteSessionAsync が呼び出されるまで、ロール情報は設定されないことに注意してください。

要件

ヘッダー: multiplayer_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

multiplayer_c
最終更新日 2026年8月13日