How To Install Side-by-Side RTC DLL

This topic describes the different ways to install the RTC DLLs (Rtcdll.dll and its dependent assemblies Rtcres.dll and Dxmrtp.dll).

How to Install the Side-by-side RTC DLLs without Creating a Windows Installer Setup

A Windows Installer setup package, RtcApiSetup.exe, is included in the SDK to install the RTC Client API version 1.3 on a machine and to use the samples. This will install the merge module on the computer so that the side-by-side RTC Client API 1.3 DLLs are available for use on that machine.

How to Use Rtcclnt.msm within a Windows Installer Setup

The Rtcclnt.msm merge module includes all the intelligence and binaries for installing the RTC Client API version 1.3 as part of a Windows Installer setup. For information on how to use merge modules within Windows Installer, see Merge Module.

Important  When you merge the Rtcclnt.msm merge module into an Windows Installer installation package (.msi), you must ensure that the MsiPublishAssemblies and MsiUnpublishAssemblies actions are present in the InstallExecuteSequence table of the .msi file. If those actions are not present when you merge Rtcclnt.msm into your .msi file, the .msi file will not install properly.

How to use RtcSxsPolicies.msi

The RTC Client version 1.3 SDK now provides RtcSxsPolicies.msi, which installs policies (publisher configuration files) that redirect any application using the side-by-side DLLs of the RTC Client API (version 1.2 and later) so that they use the 1.3 version binaries (5.2.1002.3) instead of those earlier versions of the RTC Client API. This MSI package is intended to be an example and tool for installing a policy that forces applications using the side-by-side RTC Client API DLLs to use RTC Client API version 1.3 DLLs instead of previous versions.

Note that if the RTC Client API version 1.3 DLLs are removed or uninstalled, the policies installed by RtcSxsPolicies.msi will continue to try to load the version 1.3 DLLs and the DLLs will fail to load. Therefore, if the user uninstalls the RTC Client API version 1.3 DLLs and RtcSxsPolicies.msi is still installed, they should uninstall RtcSxsPolicies.msi (so that the policy is removed and RTC client applications can use the DLLs specified in their manifests) or reinstall RTC Client API version 1.3.

In addition, if side-by-side policies are already installed for the 5.2.1002.3 RTC Client API DLLs, RtcSxsPolicies.msi will not upgrade those existing policies and an error message will be displayed that says that the component already exists (ERROR_ALREADY_EXISTS).