XblMultiplayerSessionGetRoleByName

  • [アーティクル]

XblMultiplayerRole オブジェクトをロール タイプ名とロール名でフェッチします。

構文

HRESULT XblMultiplayerSessionGetRoleByName(  
         XblMultiplayerSessionHandle handle,  
         const char* roleTypeName,  
         const char* roleName,  
         const XblMultiplayerRole** role  
)

パラメーター

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