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

# PFLobbyGetAccessPolicy

> PFLobbyGetAccessPolicy 参考，用于通过 PlayFab Multiplayer C++ SDK 大厅 API 读取 PlayFab 大厅上的当前 PFLobbyAccessPolicy 值。

获取大厅的访问策略。

## 语法

```cpp theme={null}
HRESULT PFLobbyGetAccessPolicy(  
    PFLobbyHandle lobby,  
    PFLobbyAccessPolicy* accessPolicy  
)  
```

### 参数

**`lobby`**   PFLobbyHandle

大厅的句柄。

**`accessPolicy`**   [PFLobbyAccessPolicy\*](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbyaccesspolicy.md)\
*output*

输出的访问策略。

### 返回值

类型：HRESULT

如果调用成功，则为 `S_OK`；否则为错误代码。可通过 [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md) 检索错误代码的可读形式。

## 备注

如果此大厅对象是通过调用 [PFMultiplayerJoinLobby()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby.md) 创建的，则此方法将返回错误，直到 [PFMultiplayerStartProcessingLobbyStateChanges()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges.md) 提供一个 [PFLobbyUpdatedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md)，其中 [PFLobbyUpdatedStateChange::accessPolicyUpdated](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md) 设置为 true。如果加入大厅成功，则可以保证在 PFMultiplayerStartProcessingLobbyStateChanges() 提供 [PFLobbyJoinLobbyCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbycompletedstatechange.md) 时，此字段已被填充。\
\
 如果此大厅对象是通过调用 [PFMultiplayerClaimServerLobby()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerclaimserverlobby.md) 创建的，则此方法将返回错误，直到 [PFMultiplayerStartProcessingLobbyStateChanges()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges.md) 提供一个 [PFLobbyUpdatedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md)，其中 [PFLobbyUpdatedStateChange::accessPolicyUpdated](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md) 设置为 true。如果领取大厅成功，则可以保证在 PFMultiplayerStartProcessingLobbyStateChanges() 提供 [PFLobbyClaimServerLobbyCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange.md) 时，此字段已被填充。

## 要求

**头文件：** PFLobby.h

## 另请参阅

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


## Related topics

- [PFMultiplayer C/C++ API 概览 - PFLobby.h](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [Lobby.AccessPolicy](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/AccessPolicy.md)
- [LobbyAccessPolicy](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyAccessPolicy.md)
- [PFLobbyAccessPolicy](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbyaccesspolicy.md)
- [LobbyDataUpdate.AccessPolicy](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyDataUpdate/AccessPolicy.md)