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

# PFMultiplayerInitialize

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

初始化 PlayFab 多人游戏库的实例。

## 语法

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

### 参数

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

应用的 PlayFab 标题 ID。

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

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

### 返回值

类型：HRESULT

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

## 备注

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

## 要求

**头文件：** PFMultiplayer.h

## 另请参阅

[PFMultiplayer 成员](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members)\
[PFMultiplayerSetEntityToken](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken)\
[PFMultiplayerUninitialize](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize)\
[PFMultiplayerSetMemoryCallbacks](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks)\
[PFMultiplayerSetThreadAffinityMask](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetthreadaffinitymask)


## Related topics

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