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

# XblMultiplayerManagerLobbySessionInviteFriends

> XblMultiplayerManagerLobbySessionInviteFriends

# XblMultiplayerManagerLobbySessionInviteFriends

顯示標準 XBOX UI，讓使用者選取朋友或最近的玩家，並邀請他們加入遊戲。

## 語法

```cpp theme={null}
HRESULT XblMultiplayerManagerLobbySessionInviteFriends(  
         XblUserHandle requestingUser,  
         const char* contextStringId,  
         const char* customActivationContext  
)  
```

### 參數

*requestingUser*   \_In\_\
類型：XblUserHandle

傳送邀請的使用者。

*contextStringId*   \_In\_opt\_z\_\
類型：char\*

選用。自訂內容字串識別碼，這是在 XBOX Live 擷取期間定義的字串，用來識別新增至標準邀請文字的自訂邀請文字。識別碼字串必須以三個斜線字元 (" /// ") 作為前置詞。

*customActivationContext*   \_In\_opt\_z\_\
類型：char\*

選用。啟用內容字串，這是由遊戲定義的字串，會傳遞至受邀的遊戲用戶端，並由遊戲視需要加以解譯。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

如果叫用此函式，當使用者在標準 XBOX UI 中確認玩家選取項目時，Multiplayer Manager 會傳送邀請給選取的玩家。如果選取的玩家接受邀請，遊戲就會收到通知。對於以 GDK 為基礎的遊戲，系統會叫用呼叫 [XGameInviteRegisterForEvent](/zh-TW/reference/system/xgameinvite/functions/xgameinviteregisterforevent) 函式時所指定的回呼函式來通知遊戲。對於以其他平台為基礎的遊戲，則會啟用遊戲。如需詳細資訊，請參閱[接收邀請](/zh-TW/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)。

## 需求

**標頭：** multiplayer\_manager\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

[multiplayer\_manager\_c](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerJoinLobby](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby)\
[XblMultiplayerManagerLobbySessionAddLocalUser](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser)\
[XblMultiplayerManagerLobbySessionInviteUsers](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers)


## Related topics

- [XblMultiplayerManagerLobbySessionInviteUsers](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)
- [XblMultiplayerManagerLobbySessionAddLocalUser](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md)
- [XblMultiplayerManagerJoinLobby](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)
- [使用多人遊戲管理員傳送遊戲邀請](/zh-TW/services/xbox-services/multiplayer/mpm/how-to/live-send-game-invites.md)