Edit

ConnectionSettings method of the Win32_TSClientSetting class

  • Article

The ConnectionSettings method sets the session settings that apply to the connection and logon process.

Syntax

uint32 ConnectionSettings(
  [in] uint32 ConnectClientDrivesAtLogon,
  [in] uint32 ConnectPrinterAtLogon,
  [in] uint32 DefaultToClientPrinter
);

Parameters

ConnectClientDrivesAtLogon [in]

Flag enabling or disabling the ConnectClientDrivesAtLogon property which specifies whether the client's drives are automatically connected during the logon procedure.

0

The client's drives are not automatically connected.

1

The client's drives are automatically connected.

ConnectPrinterAtLogon [in]

Flag enabling or disabling the ConnectPrinterAtLogon property, which specifies whether all mapped local client printers are automatically connected during the logon procedure.

0

All mapped local printers are not automatically connected.

1

All mapped local printers are automatically connected.

DefaultToClientPrinter [in]

Flag enabling or disabling the DefaultToClientPrinter property which specifies whether print jobs are automatically sent to the client's local printer.

0

Print jobs are not automatically sent.

1

Print jobs are automatically sent.

Return value

Returns 0 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 user's connection settings are overridden by the server.

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
TSCfgWmi.mof
DLL
TSCfgWmi.dll

See also

Win32_TSClientSetting