XblMultiplayerManagerLobbySessionInviteFriends

표준 Xbox UI를 표시하여 사용자가 친구나 최근 플레이어를 선택하고 게임에 초대할 수 있도록 합니다.

구문

HRESULT XblMultiplayerManagerLobbySessionInviteFriends(  
         XblUserHandle requestingUser,  
         const char* contextStringId,  
         const char* customActivationContext  
)  

매개 변수

requestingUser _In_
형식: XblUserHandle

초대를 보내는 사용자입니다.

contextStringId _In_opt_z_
형식: char*

선택 사항. 표준 초대 텍스트에 추가되는 사용자 지정 초대 텍스트를 식별하기 위해 Xbox Live 수집 중에 정의된 문자열인 사용자 지정 컨텍스트 문자열 ID입니다. ID 문자열에는 세 개의 슬래시 문자(" /// ")가 접두사로 지정되어야 합니다.

customActivationContext _In_opt_z_
형식: char*

선택 사항. 활성화 컨텍스트 문자열로, 초대된 게임 클라이언트에 전달되고 게임에서 원하는 대로 해석되는 게임 정의 문자열입니다.

반환 값

형식: HRESULT

이 API 작업에 대한 HRESULT 반환 코드입니다.

비고

이 함수가 호출되면 멀티 플레이어 관리자는 사용자가 표준 Xbox UI에서 플레이어 선택을 확인할 때 선택한 플레이어에게 초대를 보냅니다. 선택한 플레이어가 초대를 수락하면 타이틀이 알림을 받습니다. GDK 기반 게임의 경우 XGameInviteRegisterForEvent 함수가 호출될 때 지정된 콜백 함수를 호출하여 타이틀이 알림을 받습니다. 다른 플랫폼을 기반으로 하는 게임의 경우 타이틀이 활성화됩니다. 자세한 내용은 초대 받기를 참조하세요.

요구 사항

헤더: multiplayer_manager_c.h

도서관: Microsoft.Xbox.Services.14x.GDK.C.lib

참고 항목

multiplayer_manager_c
XblMultiplayerManagerJoinLobby
XblMultiplayerManagerLobbySessionAddLocalUser
XblMultiplayerManagerLobbySessionInviteUsers