Finding Documentation
The MPSSDK Help is automatically installed when you install the MPSSDK (default location: %SystemDrive%\Program Files\Citrix\MPSSDK\Docs). To open this help system, double-click the Mfcom.chm file.
Getting Support
Citrix provides technical support primarily through the Citrix Solutions Network (CSN) channel partners. You can contact your supplier for first-line support or use Citrix Online Technical Support to find the nearest CSN partner.
The Citrix Developer Centeris the home for all technical resources and discussions involving the use of Citrix SDKs. You can find access to SDKs, sample code and scripts, extensions and plug-ins, and SDK documentation. Also included are the Citrix Developer Network forums, where technical discussions take place around each of the Citrix SDKs.
What's New in this Release
The following features are new in this release.
• Complete support of many of the new features of Presentation Server 4.5
• Existing objects are enhanced with new interfaces that support additional functionality
• Many known issues that existed in the Presentation Server 4.0 release of MFCOM are resolved
Examples
The examples included in this SDK have not been fully tested on Windows Vista systems, although most of them should work correctly. If you are unable to run an example, try the following:
• Ensure that the user has sufficient permission to run the example. For example, an administrator's permissions may also need to include the permission to launch an application from a command line window.
• Ensure that the DCOM impersonation level is set to impersonate. Other DCOM settings may also need to be adjusted.
Some examples are provided with only source code. You may need to compile the examples using the makefiles provided, or in your own Visual Studio project.
Known Issues in this Release
Vista Support
The examples included in this SDK have not been fully tested on Windows Vista systems, although most of them should work correctly. If you are unable to run an example, try the following:
• Ensure that the user has sufficient permission to run the example. For example, an administrator's permissions may also need to include the permission to launch an application from a command line window.
• Ensure that the DCOM impersonation level is set to impersonate. Other DCOM settings may also need to be adjusted.
Examples
Some examples are provided with only source code. You may need to compile the examples using the makefiles provided, or in your own Visual Studio project.
Installation Information
Installing the MPSSDK
To install the MPSSDK:
1. Run MPSSDK.msi.
2. The installation program starts. The following tasks are completed during installation:
• Accepting the license agreement.
• Specifying a destination folder for the MPSSDK; the default installation directory is %SystemDrive%\Program Files\Citrix\MPSSDK.
• Optionally registering MFCOM for remote access.
Note: To develop applications, the MPSSDK does not need to be installed on a server running Presentation Server, but programs developed using MPSSDK functions will work only on servers running Presentation Server, or on a system that has MFCOM registered for remote access.
Upgrading the MPSSDK
Uninstall any previous version of the MPSSDK prior to installing this version. To remove a previous version, use the Add or Remove Programs utility in the Windows Control Panel.
Registering MFCOM for Remote Access
You must register MFCOM for remote access to an MFCOM server. You cannot register MFCOM for local and remote access simultaneously. To modify the registration, see the "Accessing the MFCOM Server Remotely" topic of the MPSSDK Help.
*Important:*If you registered MFCOM for remote access using MFREG from a previous version of the MPSSDK, you must remove the registration prior to installing this version. If you do not remove the previous registration first, you may encounter errors when you use this version.