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

> 로비 및 매치메이킹 사용을 위해 PlayFab Multiplayer C/C++ 라이브러리 인스턴스를 만들고 초기화하는 PFMultiplayerInitialize에 대한 참조입니다.

PlayFab Multiplayer 라이브러리의 인스턴스를 초기화합니다.

## 구문

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

### 매개 변수

**`playFabTitleId`**   char\*\
*null로 끝남*

앱의 PlayFab Title ID입니다.

**`handle`**   PFMultiplayerHandle\*\
*라이브러리에서 할당된 출력*

새로 초기화된 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)를 제외한 다른 메서드보다 먼저 호출되어야 합니다. PFMultiplayerInitialize()는 후속 [PFMultiplayerUninitialize()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize) 호출 없이는 다시 호출할 수 없습니다. <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 Title ID와 동일해야 합니다.

## 요구 사항

**헤더:** PFMultiplayer.h

## 함께 보기

[PFMultiplayer members](/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](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize.md)
- [PFMultiplayerSetEntityToken](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken.md)
- [PFMultiplayerSetThreadAffinityMask](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetthreadaffinitymask.md)
- [MPSD에서 PlayFab Multiplayer 및 MPA로 이동](/ko/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [Matchmaking SDK quickstart](/ko/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)