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

# PFLobbyGetConnectionString

> 透過 PlayFab Multiplayer C++ SDK 擷取用於加入 PlayFab 大廳之預設連接字串的 PFLobbyGetConnectionString 參考。

取得與大廳相關聯的預設連接字串。

## 語法

```cpp theme={null}
HRESULT PFLobbyGetConnectionString(  
    PFLobbyHandle lobby,  
    const char** connectionString  
)  
```

### 參數

**`lobby`**   PFLobbyHandle

大廳的控制代碼。

**`connectionString`**   char\*\*\
*程式庫配置的輸出*

輸出的連接字串。

### 傳回值

類型：HRESULT

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

## 備註

如果此大廳物件是透過呼叫 [PFMultiplayerCreateAndJoinLobby()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby.md) 建立的，則在 [PFMultiplayerStartProcessingLobbyStateChanges()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges.md) 提供成功的 [PFLobbyCreateAndJoinLobbyCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbycreateandjoinlobbycompletedstatechange.md) 之前，此方法會傳回錯誤。 \
\
 如果此大廳物件是透過呼叫 [PFMultiplayerCreateAndClaimServerLobby()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandclaimserverlobby.md) 建立的，則在 [PFMultiplayerStartProcessingLobbyStateChanges()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges.md) 提供成功的 [PFLobbyCreateAndClaimServerLobbyCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbycreateandclaimserverlobbycompletedstatechange.md) 之前，此方法會傳回錯誤。   \
\
 如果此大廳物件是透過呼叫 [PFMultiplayerClaimServerLobby()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerclaimserverlobby.md) 建立的，則在 [PFMultiplayerStartProcessingLobbyStateChanges()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges.md) 提供成功的 [PFLobbyClaimServerLobbyCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange.md) 之前，此方法會傳回錯誤。   \
\
 如果此大廳物件是透過呼叫 [PFMultiplayerJoinLobby()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby.md) 建立的，則在 [PFMultiplayerStartProcessingLobbyStateChanges()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges.md) 提供成功的 [PFLobbyJoinLobbyCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbycompletedstatechange.md) 之前，此方法會傳回錯誤。

## 需求

**標頭：** PFLobby.h

## 另請參閱

[PFLobby 成員](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)


## Related topics

- [與 PlayFab Lobby 和 Match 整合](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpa/concepts/live-mpa-playfab-integration.md)
- [從 MPSD 移至 PlayFab Multiplayer 與 MPA](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [PFMultiplayer C/C++ API 概觀 - PFLobby.h](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [Lobby.ConnectionString](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/ConnectionString.md)
- [LobbySearchResult.ConnectionString](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchResult/ConnectionString.md)