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

# PFLobbyGetLobbyId

> 使用 PlayFab Multiplayer C++ SDK 大廳 API 從 PFLobbyHandle 擷取唯一大廳識別碼的 PFLobbyGetLobbyId 參考。

取得大廳的識別碼。

## 語法

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

### 參數

**`lobby`**   PFLobbyHandle

大廳的控制代碼。

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

輸出的大廳識別碼。

### 傳回值

類型：HRESULT

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

## 備註

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

## 需求

**標頭：** PFLobby.h

## 另請參閱

[PFLobby 成員](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [處理 Lobby 和 Matchmaking C++ SDK 錯誤](/zh-TW/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-errors.md)
- [Get Lobby](/api-reference/lobby/get-lobby.md)
- [Lobby.Id](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/Id.md)
- [LobbySearchResult.LobbyId](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbySearchResult/LobbyId.md)
- [Lobby.GetLobbyProperties](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetLobbyProperties.md)