SFS2X Objective-C API  1.7.13
iOS / macOS / tvOS
ChangeRoomPasswordStateRequest.h
1 //
2 // ChangeRoomPasswordStateRequest.h
3 // SFS2X
4 //
5 // Original development by Infosfer Game Technologies Ltd. | http://www.infosfer.com.
6 //
7 // Maintained and developed by A51 Integrated.
8 // Copyright 2012 A51 Integrated | http://a51integrated.com. All rights reserved.
9 //
10 
11 #import "BaseRequest.h"
12 #import "Room.h"
13 
14 EXTERN NSString * const ChangeRoomPasswordStateRequest_KEY_ROOM;
15 EXTERN NSString * const ChangeRoomPasswordStateRequest_KEY_PASS;
16 
17 /** Changes the password of a Room at runtime.
18 
19  The request not only changes the password of a Room but also its "password state", which indicates if a Room is password protected or not.
20  This request will fail if the User sending the request is not the owner of the Room.
21 
22  Moderators and Administrator can override this constraint.
23 
24  If the Room was configured so that password change is not allowed (see the <em>RoomSettings.permissions</em> parameter), the request is ignored and no error is fired.
25 */
26 @interface ChangeRoomPasswordStateRequest : BaseRequest {
27 
28  id<Room> _room;
29  NSString *_newPass;
30 
31 }
32 
33 -(id)initWithRoom:(id<Room>)room newPass:(NSString *)newPass;
34 
35 /**
36  @param room the Room
37  @param newPass the new password (null or empty string means no password)
38 
39  @see [ISFSEvents onRoomPasswordStateChange:]
40  @see [ISFSEvents onRoomPasswordStateChangeError
41  @see ChangeRoomNameRequest
42  @see ChangeRoomPasswordStateRequest
43 
44  */
45 +(id)requestWithRoom:(id<Room>)room newPass:(NSString *)newPass;
46 
47 @end
ChangeRoomPasswordStateRequest
Definition: ChangeRoomPasswordStateRequest.h:26