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

# PFLobbySendInvite

> 使用 PlayFab Multiplayer C++ SDK 大廳 API 從本機 PlayFab 使用者向另一個實體傳送大廳邀請的 PFLobbySendInvite 參考。

從本機使用者向受邀實體傳送此大廳的邀請。

## 語法

```cpp theme={null}
HRESULT PFLobbySendInvite(  
    PFLobbyHandle lobby,  
    const PFEntityKey* sender,  
    const PFEntityKey* invitee,  
    void* asyncContext  
)  
```

### 參數

**`lobby`**   PFLobbyHandle

大廳的控制代碼。

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

傳送邀請的本機使用者。

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

受邀的實體。

**`asyncContext`**   void\*\
*選用*

選用的應用程式定義指標大小內容值，可用來將完成狀態變更與此呼叫建立關聯。

### 傳回值

類型：HRESULT

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

## 備註

這是一項非同步作業。成功完成時，遊戲會收到 [PFLobbySendInviteCompletedStateChange::result](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysendinvitecompletedstatechange) 欄位設定為 `S_OK` 的 [PFLobbySendInviteCompletedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysendinvitecompletedstatechange)。 失敗完成時，遊戲會收到 [PFLobbySendInviteCompletedStateChange::result](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysendinvitecompletedstatechange) 欄位設定為失敗的 [PFLobbySendInviteCompletedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysendinvitecompletedstatechange)。 <br /><br /> `sender` 必須是從此用戶端加入之此大廳的本機使用者。

## 需求

**標頭：** PFLobby.h

## 另請參閱

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


## Related topics

- [大廳邀請](/zh-TW/services/playfab/multiplayer/lobby/lobby-invites.md)
- [建立大廳](/zh-TW/services/playfab/multiplayer/lobby/create-a-lobby.md)
- [非同步 Lobby 和 Matchmaking C++ SDK 作業指南](/zh-TW/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-async.md)
- [PFLobbyStateChangeType](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbystatechangetype.md)
- [PFLobbySendInviteCompletedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbysendinvitecompletedstatechange.md)