Marshalling - OLE Programmer's Reference

Custom Search

Marshalling

Marshalling is the process of packaging and unpackaging parameters so a remote procedure call can take place. Different parameter types are marshalled in different ways. For example, marshalling an integer parameter involves simply copying the value into the message buffer (although even in this simple case, there are issues such as byte ordering to deal with with cross-machine calls). Marshalling an array, however, is a more complex process. Array members are copied in a specific order so that the other side can reconstruct the array exactly. When a pointer is marshalled, the data that the pointer is pointing to is copied following rules and conventions for dealing with nested pointers in structures. Unique functions exist to handle the marshalling of each parameter type.

There are two types of OLE marshalling: standard and custom.

With standard marshalling, the proxies and stubs are system-wide resources for the interface, and they interact with the channel through a standard protocol. Standard marshalling can be used by both standard OLE interfaces and custom interfaces:

In the case of most OLE interfaces, the proxies and stubs for standard marshalling are themselves in-process component objects which are loaded from a system-wide DLL provided by OLE, OLE32.DLL.
In the case of custom interfaces, the proxies and stubs for standard marshalling are generated by the interface designer, typically with MIDL. These proxies and stubs are statically configured in the registry, so any potential client can use the custom interface across process boundaries. These proxies and stubs are loaded from a DLL that is located via the system registry using the interface ID (IID) for the custom interface they marshal.

Standard marshalling is the default method for the provision of marshalling code when passing interface pointers. However, because multiple objects may implement a single interface any number of ways, standard marshalling may not be sufficient for a particular implementation. Therefore, any object may override the default and provide custom marshalling for its interfaces. Other implementations of the interface are not affected.

As an alternative to standard marshalling, an interface (standard or custom) can use custom marshalling. With custom marshalling, an object dynamically implements the proxies at run-time for each interface that it supports. For any given interface, the object can select OLE-provided standard marshalling or custom marshalling. This choice is made by the object on an interface by interface basis. Once the choice is made for a given interface, it remains in effect during the object's lifetime. However one interface on an object can use custom marshalling while another uses standard marshalling.

Custom marshalling is inherently unique to the object application that implements it. It uses proxies implemented by the object and provided to the system on request at run-time. Objects that custom-marshal must implement the IMarshal interface, whereas objects that support standard marshalling do not. For complete documentation of the IMarshal interface, see the OLE Reference Guide. Also, see the chapter "The Component Object Model" for more information on marshalling.

Marshalling support is provided by the system for all OLE-defined interfaces. This support is via component objects in the file OLE32.DLL. If you decide to write a custom interface, you must provide marshalling support for it. Typically, you will provide a standard marshalling DLL for the interface you design. You can use the tools contained in the Win32 SDK CD to create the proxy/stub code and the proxy/stub DLL.

Last news from Greatis Software

    Nostalgia .Net     .Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More »

Recommended software for developers

    Ultimate Pack     Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More »

    Form Designer .Net     Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More »

    Print Suite .Net     Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More »

    Gradient Controls .Net     Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More »

    Greatis iGrid     iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More »

All the contacts and projects

Dmitry Vasiliev (just.dmitry)

More Online Helps

Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages

greatis just4fun network