SetAllowTSConnections method of the Win32_TerminalServiceSetting class
The SetAllowTSConnections method allows or denies new remote desktop connections. This method will modify the AllowTSConnections property for the class accordingly.
Syntax
uint32 SetAllowTSConnections(
[in] uint32 AllowTSConnections,
[in] uint32 ModifyFirewallException
);
Parameters
-
AllowTSConnections [in]
-
Specifies whether new remote desktop connections are allowed. This must be one of the following values.
-
0
-
New connections are not allowed. If the ModifyFirewallException parameter is 1, then the Remote Desktop firewall exception is disabled.
-
1
-
New connections are allowed. If the ModifyFirewallException parameter is 1, then the Remote Desktop firewall exception is enabled.
ModifyFirewallException [in]
Specifies if the firewall exception setting for Remote Desktop will be modified to the state specified by the AllowTSConnections parameter. This must be one of the following values.
0
Do not modify the firewall exception setting.
1
Modify the firewall exception setting.
Return value
Returns Success on success; otherwise, returns a WMI error code. Refer to Remote Desktop Services WMI Provider Error Codes for a list of these values. The method returns an error if the setting is under group policy control.
Remarks
Managed Object Format (MOF) files contain the definitions for Windows Management Instrumentation (WMI) classes. MOF files are not installed as part of the Microsoft Windows Software Development Kit (SDK). They are installed on the server when you add the associated role by using the Server Manager. For more information about MOF files, see Managed Object Format (MOF).
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMv2\TerminalServices |
| MOF |
|
| DLL |
|