> ## 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\*\
*以 null 結尾*

應用程式的 PlayFab 遊戲識別碼。

**`handle`**   PFMultiplayerHandle\*\
*程式庫配置的輸出*

新初始化之 PFMultiplayer API 執行個體的輸出控制代碼。

### 傳回值

類型：HRESULT

如果呼叫成功，則為 `S_OK`；否則為錯誤碼。可透過 [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md) 擷取錯誤碼的人類可讀形式。

## 備註

除了 [PFMultiplayerSetMemoryCallbacks()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetmemorycallbacks.md) 和 [PFMultiplayerSetThreadAffinityMask()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetthreadaffinitymask.md) 之外，必須先呼叫此方法，才能呼叫任何其他方法。在後續呼叫 [PFMultiplayerUninitialize()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize.md) 之前，無法再次呼叫 PFMultiplayerInitialize()。\
\
 每次呼叫 PFMultiplayerInitialize() 都應該有對應的 PFMultiplayerUninitialize() 呼叫。   \
\
 使用 Microsoft Game Core 版本 Multiplayer 程式庫的應用程式，必須等候 Game Core 網路堆疊初始化之後，才能呼叫此方法。可以使用 Game Core XNetworkingGetConnectivityHint API 來判斷網路堆疊的狀態。   \
\
 提供的 `playFabTitleId` 必須與用來取得 PlayFab 實體索引鍵和實體權杖的 PlayFab 遊戲識別碼相同，這些實體索引鍵和權杖將傳遞給 [PFMultiplayerSetEntityToken()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken.md)。

## 需求

**標頭：** PFMultiplayer.h

## 另請參閱

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


## Related topics

- [PFMultiplayerUninitialize](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize.md)
- [PFMultiplayerSetEntityToken](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken.md)
- [PFMultiplayerSetThreadAffinityMask](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetthreadaffinitymask.md)
- [從 MPSD 移至 PlayFab Multiplayer 與 MPA](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [Matchmaking SDK 快速入門](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)