SAMPLE: Marshaling Code for Connection Point Interfaces

ID: Q149231

The information in this article applies to:

Microsoft OLE Libraries, used with:
- Microsoft Windows NT 3.51
- Microsoft Windows 95

SUMMARY

CXPRX provides 32-bit marshaling code for the IConnectionPoint, IConnectionPointContainer, IEnumConnections, and IEnumConnectionPoints interfaces. The next version of Windows and Windows NT will provide marshaling code for these interfaces, so be sure to follow the installation instructions specified below to prevent accidental overwriting of the system provided marshaling code.

The following file is available for download from the Microsoft Download Center. Click the file name below to download the file:

CXPRX.exe

For more information about how to download files from the Microsoft Download Center, please visit the Download Center at the following Web address

http://www.microsoft.com/downloads/search.asp

and then click How to use the Microsoft Download Center.

After downloading the file, run it in an empty directory with the -d switch to set up the directory structure:

CXPRX.EXE -d

NOTE: The x86 directory contains a build of CXPRX.DLL that will work on Windows 95 and the Intel x86 version of Windows NT 3.51. The MIPS and Alpha directories contain builds of CXPRX.DLL for use on the MIPS and Alpha versions of Windows NT 3.51. This code will not work with 16-bit applications. Please do not modify the code or the version number. Change the CPU variable in the makefile to build for different platforms.

MORE INFORMATION

The connection point interfaces (IConnectionPoint, IConnectionPointContainer, IEnumConnections, and IEnumConnectionPoints) are used by components to implement event handling. These interfaces are documented in the OLE Controls documentation. Windows 95 and Windows NT 3.51 did not provide marshaling code for these interfaces. Consequently these interfaces could only be used with inproc objects on these platforms. The marshaling code provided here allows these interfaces to be used by out- of-process objects on the Windows NT 3.51 and Windows 95 platforms.

The next version of Windows and Windows NT will provide marshaling code for the connection point interfaces. To prevent the overwriting of this system provided marshaling code, it is important that you follow the following installation instructions when you install the marshaling code provided here:

Installation Instructions

An installation program that installs the marshaling code should follow these steps:

The installation program should check the system directory (determined at installation time by using the GetSystemDirectory() Win32 API) for the existence of CXPRX.DLL. If it exists and if the standard version- checking APIs indicate that it is a later version than the CXPRX.DLL provided by the installation program, it should not be overwritten and installation is complete. The version of CXPRX.DLL provided here is 1,0,0,3 (See CXPRX.RC). If CXPRX.DLL exists in the system directory but if it is an earlier version, overwrite it and installation is complete. If CXPRX.DLL does not exist in the system directory, go to step 2.

The installation program should check for the existence of the following registry key to determine whether to continue installation or not:
```
      if (ERROR_SUCCESS != RegQueryValueEx(
      HKEY_CLASSES_ROOT,
      "Interface\\{B196B285-BAB4-101A-B69C-
       00AA00341D07}\\ProxyStubClsid32",
      NULL, REG_SZ, NULL, NULL))
      {
       ... go to step 3 ...
      }
      // else installation is complete; 
```
This check prevents accidental overwriting of the system's installed marshaling code when the system does provide marshaling of these interfaces in the future. So if this key is present, marshaling code for these interfaces exists and the installation is complete.

If installation gets past step 2, CXPRX.DLL should be copied to the system directory. Then the marshaling code must be registered in the registry by running REGSVR32.EXE CXPRX.DLL. REGSVR32.EXE will call the exported DllRegisterServer function in CXPRX.DLL to register the marshaling code. Installation is now complete.

Additional query words: kbOLE200 kbOLEArc kbSDKWin32 kbDSupport

Keywords : kbfile kbsample kbAutomation kbNTOS350 kbNTOS351 kbOLE200 kbWinOS95 kbGrpCom kbDSupport
Version : :
Platform : NT WINDOWS
Issue type : kbhowto