> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFMultiplayerInitialize

> Referência de PFMultiplayerInitialize, que cria e inicializa uma instância da biblioteca C/C++ do PlayFab Multiplayer para uso com lobby e matchmaking.

Inicializa uma instância da biblioteca do PlayFab Multiplayer.

## Sintaxe

```cpp theme={null}
HRESULT PFMultiplayerInitialize(  
    const char* playFabTitleId,  
    PFMultiplayerHandle* handle  
)  
```

### Parâmetros

**`playFabTitleId`**   char\*\
*terminada em nulo*

A Title ID do PlayFab do aplicativo.

**`handle`**   PFMultiplayerHandle\*\
*saída alocada pela biblioteca*

O identificador de saída da instância da API PFMultiplayer recém-inicializada.

### Valor retornado

Tipo: HRESULT

`S_OK` se a chamada tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md).

## Comentários

Este método precisa ser chamado antes de qualquer outro método, exceto [PFMultiplayerSetMemoryCallbacks()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks.md) e [PFMultiplayerSetThreadAffinityMask()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetthreadaffinitymask.md). PFMultiplayerInitialize() não pode ser chamado novamente sem uma chamada subsequente a [PFMultiplayerUninitialize()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize.md). \
\
&#x20;Toda chamada a PFMultiplayerInitialize() deve ter uma chamada correspondente a PFMultiplayerUninitialize().   \
\
&#x20;Os aplicativos que usam a versão Microsoft Game Core da biblioteca Multiplayer precisarão aguardar a inicialização da pilha de rede do Game Core antes de chamar este método. O status da pilha de rede pode ser determinado usando a API XNetworkingGetConnectivityHint do Game Core.   \
\
&#x20;O `playFabTitleId` fornecido precisa ser a mesma Title ID do PlayFab usada para obter as chaves de entidade e os tokens de entidade do PlayFab que serão passados para [PFMultiplayerSetEntityToken()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken.md).

## Requisitos

**Cabeçalho:** PFMultiplayer.h

## Confira também

[Membros do PFMultiplayer](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members.md)\
[PFMultiplayerSetEntityToken](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken.md)
[PFMultiplayerUninitialize](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize.md)
[PFMultiplayerSetMemoryCallbacks](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks.md)
[PFMultiplayerSetThreadAffinityMask](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetthreadaffinitymask.md)


## Related topics

- [PFMultiplayerUninitialize](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize.md)
- [PFMultiplayerSetEntityToken](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken.md)
- [PFMultiplayerSetThreadAffinityMask](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetthreadaffinitymask.md)
- [Início rápido do SDK de Matchmaking](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [Início rápido do SDK do Lobby](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/lobby-getting-started.md)
