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

Minimum supported client

None supported

Minimum supported server

Windows Server 2008

Namespace

Root\CIMv2

MOF

TlsWmiProv.mof

DLL

TlsWmiProv.dll

See also

Win32_TSLicenseServer

 

 

Show: