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

# PFMultiplayerClaimServerLobby

> PlayFab Multiplayer C++ SDK 経由で、game_server として既存のサーバー所有 PlayFab ロビーの所有権を要求するための PFMultiplayerClaimServerLobby リファレンス。

既存のサーバー ロビーの所有権を要求します。

## 構文

```cpp theme={null}
HRESULT PFMultiplayerClaimServerLobby(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* server,  
    const char* lobbyId,  
    void* asyncContext,  
    PFLobbyHandle* lobby  
)  
```

### パラメーター

**`handle`**   PFMultiplayerHandle

PFMultiplayer API インスタンスのハンドル。

**`server`**   [PFEntityKey\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

ロビーを要求するゲーム サーバーの PlayFab エンティティ キー。エンティティ タイプは "game\_server" である必要があります。

**`lobbyId`**   char\*\
*null 終端*

要求対象のロビー ID。

**`asyncContext`**   void\*\
*省略可能*

完了状態の変化をこの呼び出しに関連付けるために使用できる、アプリ定義のポインター サイズのコンテキスト値 (省略可能)。

**`lobby`**   PFLobbyHandle\*\
*省略可能、ライブラリが割り当てる出力*

この操作の完了に対して即時に実行する操作をキューに登録するために使用できる、省略可能なロビー オブジェクトの出力。

### 戻り値

型: HRESULT

呼び出しが成功した場合は `S_OK`、それ以外の場合はエラー コード。エラー コードの人間が判読可能な形式は、[PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) を通じて取得できます。

## 解説

この機能を使用するには、PFLobby.h をインクルードする前に PFMULTIPLAYER\_INCLUDE\_SERVER\_APIS を定義する必要があります。<br /><br /> これは非同期操作です。正常に完了すると、タイトルには [PFLobbyClaimServerLobbyCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange) フィールドが `S_OK` に設定された [PFLobbyClaimServerLobbyCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange) が提供されます。失敗して完了した場合、タイトルには [PFLobbyClaimServerLobbyCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange) フィールドが失敗に設定された [PFLobbyClaimServerLobbyCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange) が提供されます。<br /><br /> この操作は主に、所有者が切断されている、または切断予定であるサーバー所有ロビーを game\_server エンティティが取り込む用途を想定しています。通常、これは所有権を別の game\_server エンティティに移行したい game\_server エンティティや、クラッシュなどの致命的な障害によりロビー ハンドルへのアクセスを失ったサーバーの所有権を回復する必要のある game\_server エンティティで有用です。<br /><br /> ゲーム サーバーは、他の game\_server エンティティが現在接続しているロビーの所有権を要求することはできません。

## 要件

**ヘッダー:** PFLobby.h

## 関連項目

[PFLobby メンバー](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PFLobbyGetLobbyProperty](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbyproperty.md)
- [PFLobbyGetLobbyPropertyKeys](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbypropertykeys.md)
- [PFLobbyGetMembers](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers.md)
- [PFLobbyGetSearchProperty](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetsearchproperty.md)
- [PFLobbyGetSearchPropertyKeys](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetsearchpropertykeys.md)