1 /*---------------------------------------------------------------------------*
2 
3 Copyright (C) Nintendo.  All rights reserved.
4 
5 These coded instructions, statements, and computer programs contain
6 proprietary information of Nintendo of America Inc. and/or Nintendo
7 Company Ltd., and are protected by Federal copyright law.  They may
8 not be disclosed to third parties or copied or duplicated in any form,
9 in whole or in part, without the prior written consent of Nintendo.
10 
11  *---------------------------------------------------------------------------*/
12 
13 #ifndef NN_ACT_API_PARENTAL_CONTROLS_H_
14 #define NN_ACT_API_PARENTAL_CONTROLS_H_
15 
16 
17 #include "act_Types.h"
18 
19 
20 #ifdef __cplusplus
21 
22 namespace nn
23 {
24 namespace act
25 {
26 
27 //! @addtogroup  nn_act_api
28 //! @{
29 
30 //! @name  Controlling Parental Control Checks
31 //! @{
32 
33 /*!
34 @brief  Gets whether the parental control check for <b>Online Interaction in Games</b> is enabled during service authentication.
35 
36 Note that this function does not retrieve whether online interaction in games is being restricted; it retrieves whether the restriction setting for online interaction in games is being checked.
37 This function does not change the operations of <b>Parental Controls</b> except for the <b>Online Interaction in Games</b> setting. @n
38 
39 This setting affects not only the account library function that gets a service token, but also logging in to the NEX library, OLV library initialization, and other processes.
40 In addition, this value is enabled only for requests from the application that called this function while it continues to run. @n
41 
42 @return  Returns <tt>true</tt> if the parental control check is enabled for <b>Online Interaction in Games</b>; otherwise, it returns <tt>false</tt>.
43 */
44 bool IsParentalControlCheckEnabled( void );
45 
46 /*!
47 @brief  Enables or disables the parental control check for <b>Online Interaction in Games</b> during service authentication.
48 
49 By default, this is enabled.
50 If you disable the parental control check for <b>Online Interaction in Games</b> using this function, always be sure to handle parental control appropriately in your own code. @n
51 
52 This function does not change the operations of <b>Parental Controls</b> except for the <b>Online Interaction in Games</b> setting. @n
53 
54 This setting affects not only the account library function that gets a service token, but also logging in to the NEX library, OLV library initialization, and other processes.
55 In addition, this value is enabled only for requests from the application that called this function while it continues to run. @n
56 
57 This function is not thread-safe with other functions that it affects, such as <tt>@ref nn::act::IsParentalControlCheckEnabled</tt>, <tt>@ref nn::act::AcquireIndependentServiceToken</tt>, and <tt>@ref nn::act::AcquireEcServiceToken</tt>.
58 
59 @param[in] isEnabled  Specifies whether to enable the parental control check for <b>Online Interaction in Games</b>.
60 */
61 void EnableParentalControlCheck( bool isEnabled );
62 
63 //! @}
64 
65 //! @}
66 
67 }
68 }
69 
70 #endif
71 
72 
73 #endif  // NN_ACT_API_PARENTAL_CONTROLS_H_
74