Changes the password of a Room.

Namespace: Sfs2X.Requests
Assembly: SmartFox2X (in SmartFox2X.dll) Version: 1.7.0.0 (1.7.0)

Syntax

C#
public class ChangeRoomPasswordStateRequest : BaseRequest

Remarks

This request not only changes the password of a Room, but also its "password state", which indicates if the Room is password protected or not.

If the operation is successful, the ROOM_PASSWORD_STATE_CHANGE event is dispatched to all the users who subscribed the Group to which the target Room belongs, including the requester user himself. If the user is not the creator (owner) of the Room, or if the Room was configured so that password changing is not allowed (see the RoomSettings.Permissions parameter), the ROOM_PASSWORD_STATE_CHANGE_ERROR event if fired. An administrator or moderator can override the first constrain (he is not requested to be the Room's owner).

Examples

The following example changes the password of an existing Room:
 Copy imageCopy
void SomeMethod() {
    sfs.AddEventListener(SFSEvent.ROOM_PASSWORD_STATE_CHANGE, OnRoomPasswordStateChange);
    sfs.AddEventListener(SFSEvent.ROOM_PASSWORD_STATE_CHANGE_ERROR, OnRoomPasswordStateChangeError);
    Room theRoom = sfs.GetRoomByName("Gonzo's Room");
    sfs.Send( new ChangeRoomPasswordStateRequest(theRoom, "mammamia") );
}
void OnRoomPasswordStateChange(BaseEvent evt) {
    Room theRoom = (Room)evt.Params["room"];
    Console.WriteLine("The password of Room " + theRoom.Name + " was changed successfully");                        // .Net / Unity
    System.Diagnostics.Debug.WriteLine("The password of Room " + theRoom.Name + " was changed successfully");       // Windows Universal
}
void OnRoomPasswordStateChangeError(BaseEvent evt) {
    Console.WriteLine("Room password change failed: " + (string)evt.Params["errorMessage"]);                        // .Net / Unity
    System.Diagnostics.Debug.WriteLine("Room password change failed: " + (string)evt.Params["errorMessage"]);       // Windows Universal
}

Inheritance Hierarchy

System..::..Object
  BaseRequest
    Sfs2X.Requests..::..ChangeRoomPasswordStateRequest

See Also