> ## 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

> PFMultiplayerInitialize 的参考，用于创建并初始化 PlayFab Multiplayer C/C++ 库的实例，以便用于大厅和匹配。

初始化 PlayFab Multiplayer 库的实例。

## 语法

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

### 参数

**`playFabTitleId`**   char\*\
*is null-terminated*

应用的 PlayFab Title ID。

**`handle`**   PFMultiplayerHandle\*\
*library-allocated output*

新初始化的 PFMultiplayer API 实例的输出句柄。

### 返回值

类型：HRESULT

如果调用成功，则返回 `S_OK`；否则返回错误代码。可通过 [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md) 检索错误代码的可读形式。

## 备注

除 [PFMultiplayerSetMemoryCallbacks()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks.md) 和 [PFMultiplayerSetThreadAffinityMask()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetthreadaffinitymask.md) 之外，必须在调用任何其他方法之前调用此方法。如果未随后调用 [PFMultiplayerUninitialize()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize.md)，则无法再次调用 PFMultiplayerInitialize()。\
\
 每次对 PFMultiplayerInitialize() 的调用都应有对应的 PFMultiplayerUninitialize() 调用。\
\
 使用 Microsoft Game Core 版本的多人游戏库的应用需要在调用此方法之前等待 Game Core 网络堆栈初始化完成。可以使用 Game Core XNetworkingGetConnectivityHint API 确定网络堆栈的状态。\
\
 提供的 `playFabTitleId` 必须与用于获取将传递给 [PFMultiplayerSetEntityToken()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken.md) 的 PlayFab 实体密钥和实体令牌所使用的 PlayFab Title ID 相同。

## 要求

**头文件：** PFMultiplayer.h

## 另请参阅

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


## Related topics

- [PFMultiplayerUninitialize](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize.md)
- [PFMultiplayerSetEntityToken](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken.md)
- [PFMultiplayerSetThreadAffinityMask](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetthreadaffinitymask.md)
- [Lobby SDK 快速入门](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/lobby-getting-started.md)
- [Matchmaking SDK 快速入门](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)