SetAuthenticationPluginAndRecycleRpcApplicationPools method of the Win32_TSGatewayServerSettings class

Sets the current authentication plug-in for the Remote Desktop Gateway (RD Gateway) server and recycles the RPC application pools in IIS.

This method is equivalent to calling the SetAuthenticationPlugin and RecycleRpcApplicationPools methods in sequence.

Syntax

uint32 SetAuthenticationPluginAndRecycleRpcApplicationPools(
  [in] string PluginName
);

Parameters

PluginName [in]

Type: string

Name of the authentication plug-in

Return value

Type: uint32

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

Calling this method results in all existing connections being disconnected.

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 R2
Namespace
Root\CIMv2\TerminalServices
MOF
TSGateway.mof
DLL
AagWmi.dll

See also

Win32_TSGatewayServerSettings

SetAuthenticationPlugin

RecycleRpcApplicationPools