ChangeRole method of the Win32_TSLicenseServer class

Changes the discovery scope of the Remote Desktop license server. The discovery scope determines which Remote Desktop Session Host (RD Session Host) servers on the network can automatically discover the license server.

Syntax

uint32 ChangeRole(
  [in] uint32 ServerRole
);

Parameters

ServerRole [in]

Discovery scope for the Remote Desktop license server. You can set one of the following values.

0

RD Session Host servers in the same workgroup can discover the license server.

1

RD Session Host servers in the same domain can discover the license server. You must be logged on as a domain administrator to set this value.

2

RD Session Host servers from multiple domains in the same forest can discover the license server. You must be logged on as an enterprise administrator to set this value.

Return value

If the method succeeds, it returns zero. If the method is unsuccessful, it returns a nonzero value. For a list of error codes, see Remote Desktop Services WMI Provider Error Codes.

Remarks

You must be a member of the Administrators group to call this method.

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
None supported
Minimum supported server
Windows Server 2008
Namespace
Root\CIMv2
MOF
TlsWmiProv.mof
DLL
TlsWmiProv.dll

See also

Win32_TSLicenseServer