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

# 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()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) 擷取錯誤碼的人類可讀形式。

## 備註

搜尋屬性會以中繼資料的形式對大廳的非成員顯示，可用於篩選和排序大廳搜尋結果。 <br /><br /> 如果此大廳物件仍在透過呼叫 [PFMultiplayerCreateAndJoinLobby()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby)、[PFMultiplayerCreateAndClaimServerLobby](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandclaimserverlobby)、[PFMultiplayerClaimServerLobby()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerclaimserverlobby) 或 [PFMultiplayerJoinLobby()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby) 以非同步方式建立、加入或宣告的過程中，此方法將不會傳回任何索引鍵。

## 需求

**標頭：** PFLobby.h

## 另請參閱

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


## Related topics

- [PFLobbyGetSearchProperty](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetsearchproperty.md)
- [Lobby.GetSearchProperties](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetSearchProperties.md)
- [PFLobbyGetLobbyPropertyKeys](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbypropertykeys.md)
- [PFLobbyGetMemberPropertyKeys](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberpropertykeys.md)
- [PFLobbyGetServerPropertyKeys](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetserverpropertykeys.md)