This function is part of the Lobby Interface.
Get the name of the RTC room associated with a specific lobby a local user belongs to.
This value can be used whenever you need a RoomName value in the RTC_* suite of functions. RTC Room Names must not be used with
EOS_RTC_JoinRoom, EOS_RTC_LeaveRoom, or EOS_RTC_AddNotifyDisconnected. Doing so will return EOS_AccessDenied or
EOS_INVALID_NOTIFICATIONID if used with those functions.
This function will only succeed when called on a lobby the local user is currently a member of.
Return Value
EOS_Success if a room exists for the specified lobby, there was enough space in OutBuffer, and the name was written successfully
EOS_NotFound if the lobby does not exist
EOS_Disabled if the lobby exists, but did not have the RTC Room feature enabled when created
EOS_InvalidParameters if you pass a null pointer on invalid length for any of the parameters
EOS_LimitExceeded The OutBuffer is not large enough to receive the room name. InOutBufferLength contains the required minimum length to perform the operation successfully.
Parameters
EOS_Lobby_GetRTCRoomName
Parameter Type And Name
|
Usage Information
|
EOS_HLobby Handle
|
|
const EOS_Lobby_GetRTCRoomNameOptions* Options
|
Structure containing information about the RTC room name to retrieve
|
char* OutBuffer
|
The buffer to store the null-terminated room name string within
|
uint32_t* InOutBufferLength
|
In: The maximum amount of writable chars in OutBuffer, Out: The minimum amount of chars needed in OutBuffer to store the RTC room name (including the null-terminator)
|
This function is part of the Lobby Interface.
Get the name of the RTC room associated with a specific lobby a local user belongs to.
This value can be used whenever you need a RoomName value in the RTC_* suite of functions. RTC Room Names must not be used with
EOS_RTC_JoinRoom, EOS_RTC_LeaveRoom, or EOS_RTC_AddNotifyDisconnected. Doing so will return EOS_AccessDenied or
EOS_INVALID_NOTIFICATIONID if used with those functions.
This function will only succeed when called on a lobby the local user is currently a member of.
Return Value
EOS_Success if a room exists for the specified lobby, there was enough space in OutBuffer, and the name was written successfully
EOS_NotFound if the lobby does not exist
EOS_Disabled if the lobby exists, but did not have the RTC Room feature enabled when created
EOS_InvalidParameters if you pass a null pointer on invalid length for any of the parameters
EOS_LimitExceeded The OutBuffer is not large enough to receive the room name. InOutBufferLength contains the required minimum length to perform the operation successfully.
Parameters
Lobby.LobbyInterface.GetRTCRoomName
Parameter Type And Name
|
Usage Information
|
GetRTCRoomNameOptions options
|
Structure containing information about the RTC room name to retrieve
|
string outBuffer
|
The buffer to store the null-terminated room name string within
|
Was this document useful?
Thank you for the response!
You’ve marked this document as useful:
yes
You’ve marked this document as not useful:
no