Pular para o conteúdo principal

XblMultiplayerSessionGetRoleByName

Busca o objeto XblMultiplayerRole pelo nome do tipo de função e pelo nome da função.

Sintaxe

Parâmetros

handle   _In_
Tipo: XblMultiplayerSessionHandle
Identificador da sessão multijogador. roleTypeName   _In_z_
Tipo: char*
Nome do tipo de função ao qual a função pertence. roleName   _In_z_
Tipo: char*
Nome da função. role   _Out_
Tipo: XblMultiplayerRole**
Retorna um ponteiro para o objeto de função com informações sobre a função. A memória do ponteiro permanecerá válida durante a vida útil do objeto XblMultiplayerSessionHandle, até que ele seja fechado. Se essa função não existir, nullptr será retornado.

Valor retornado

Tipo: HRESULT Código de retorno HRESULT desta operação de API.

Comentários

Observe que as sessões recém-criadas não terão as informações de função preenchidas até que XblMultiplayerWriteSessionAsync seja chamado.

Requisitos

Cabeçalho: multiplayer_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.lib

Confira também

multiplayer_c
Última modificação em 6 de outubro de 2026