Raw COM Acces

The designers of Comet have tried to avoid making the wrappers do too much implicitly, prefering discrete but explicit ways of triggering functionality.

In order to provide interaction of Comet classes with their COM counterparts, a standard set of methods have been used, effectively providing a COM wrapper concept.

  • in(): Return a pointer suitable for [in] parameters,
  • out(): Return a pointer suitable for [out] parameters, first freeing memory allocated,
  • inout(): Return a pointer suitable for [in,out] parameters.
  • detach(): Detach and return the internal pointer from the object
  • in_ptr(): {optional} Return a pointer suitable for [out] parameter where a pointer is required, first freeing memory allocated
  • get(): {optional} Returns a pointer to the internal pointer (same as STL pointers)
  • auto_attach( RAW_TYPE ): Cause an assignment to attach the object to the specified raw COM type.
  • create_reference( RAW_TYPE ): Static method to create a propper wrapper reference to the specified raw object.
  • create_const_reference( RAW_TYPE ): Static method to create a const wrapper reference to the specified raw object.