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

# PFLobbyGetSearchPropertyKeys

> 透過 PlayFab Multiplayer C++ SDK API 列舉 PlayFab 大廳上可搜尋屬性索引鍵的 PFLobbyGetSearchPropertyKeys 參考。

取得搜尋屬性索引鍵的清單。

## 語法

```cpp theme={null}
HRESULT PFLobbyGetSearchPropertyKeys(  
    PFLobbyHandle lobby,  
    uint32_t* propertyCount,  
    const char* const** keys  
)  
```

### 參數

**`lobby`**   PFLobbyHandle

大廳的控制代碼。

**`propertyCount`**   uint32\_t\*\
*輸出*

輸出的搜尋屬性計數。

**`keys`**   char\* const\*\*\
*大小為 `*propertyCount` 的程式庫配置輸出陣列*

輸出的搜尋屬性索引鍵陣列。

### 傳回值

類型：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)、[PFMultiplayerCreateAndClaimServerLobby](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandclaimserverlobby.md)、[PFMultiplayerClaimServerLobby()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerclaimserverlobby.md) 或 [PFMultiplayerJoinLobby()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby.md) 以非同步方式建立、加入或宣告的過程中，此方法將不會傳回任何索引鍵。

## 需求

**標頭：** PFLobby.h

## 另請參閱

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


## Related topics

- [PFMultiplayer C/C++ API 概觀 - PFLobby.h](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [PFLobbyGetSearchProperty](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetsearchproperty.md)
- [Lobby.GetSearchProperties](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetSearchProperties.md)
- [PFLobbyGetLobbyPropertyKeys](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbypropertykeys.md)
- [PFLobbyGetMemberPropertyKeys](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberpropertykeys.md)