comstl/comstl.h File Reference

---

Detailed Description

[C, C++; requires COM] The root header for the COMSTL project.

#include <stlsoft/stlsoft.h>
#include <objbase.h>

Go to the source code of this file.

Namespaces
namespace	comstl
Defines
#define	COMSTL_INCL_H_COMSTL
	Defined for backward-compatiblity.
#define	_COMSTL_VER_MAJOR   1
	The major version number of COMSTL.
#define	_COMSTL_VER_MINOR   9
	The minor version number of COMSTL.
#define	_COMSTL_VER_REVISION   1
	The revision version number of COMSTL.
#define	_COMSTL_VER   _COMSTL_VER_1_9_1
	The current composite version number of COMSTL.
#define	COMSTL_ASSERT(expr)   STLSOFT_ASSERT(expr)
	Defines a runtime assertion.
#define	COMSTL_MESSAGE_ASSERT(msg, expr)   STLSOFT_MESSAGE_ASSERT(msg, expr)
	Defines a runtime assertion, with message.
#define	COMSTL_STATIC_ASSERT(expr)   STLSOFT_STATIC_ASSERT(expr)
	Defines a compile-time assertion.
#define	__COMSTL_CF_DCOM_SUPPORT
#define	comstl_ns_qual(x)   ::comstl::x
	Qualifies with comstl:: if COMSTL is using namespaces or, if not, does not qualify.
#define	comstl_ns_using(x)   using ::comstl::x;
	Declares a using directive (with respect to comstl) if COMSTL is using namespaces or, if not, does nothing.
#define	comstl_ns_qual_std(x)   ::std::x
	Qualifies with std:: if COMSTL is being translated in the context of the standard library being within the std namespace or, if not, does not qualify.
#define	comstl_ns_using_std(x)   using ::std::x;
	Declares a using directive (with respect to std) if COMSTL is being translated in the context of the standard library being within the std namespace or, if not, does nothing.
#define	COMSTL_ITF_CALL(p)   (p)
	Resolves to p->lpVtbl for C compilation, and to p in C++.
#define	COMSTL_ITF_THIS(p)
	Resolves to p, for C compilation, and to nothing in C++.
#define	COMSTL_ITF_THIS0(p)
	Resolves to p for C compilation, and to nothing in C++.
#define	COMSTL_IID_2_REF(iid)   (iid)
	Resolves to &iid for C compilation, and to iid in C++.
#define	COMSTL_REF_2_PTR(iid)   (&(iid))
	Resolves to iid for C compilation, and to &iid in C++.
#define	COMSTL_PTR_2_REF(piid)   (*(piid))
	Resolves to piid for C compilation, and to *piid in C++.
#define	COMSTL_ACCESS_VARIANT_MEM_BYPTR(pvar, mem)   (pvar)->mem
#define	COMSTL_ACCESS_VARIANT_MEM_BYREF(var, mem)   COMSTL_ACCESS_VARIANT_MEM_BYPTR(&(var), mem)
	Used to provide access to the mem member of a VARIANT structure in a language-independent manner.
#define	COMSTL_ACCESS_VARIANT_vt_BYPTR(pvar)   (pvar)->vt
#define	COMSTL_ACCESS_VARIANT_vt_BYREF(var)   COMSTL_ACCESS_VARIANT_vt_BYPTR(&(var))
	Used to provide access to the vt member of a VARIANT structure in a language-independent manner.
#define	COMSTL_ACCESS_VARIANT_decVal_BYPTR(pvar)   (pvar)->decVal
#define	COMSTL_ACCESS_VARIANT_decVal_BYREF(var)   COMSTL_ACCESS_VARIANT_decVal_BYPTR(&(var))
#define	comstl_destroy_instance(t, _type, p)   STLSOFT_DESTROY_INSTANCE(t, _type, p)
	[DEPRECATED] Destroys the given instance p of the given type (t and _type)
#define	comstl_gen_opaque(_htype)   STLSOFT_GEN_OPAQUE(_htype)
	[DEPRECATED] Generates an opaque type with the name _htype
Variables
const size_t	COMSTL_CCH_GUID = 38

---

Define Documentation

#define _COMSTL_VER   _COMSTL_VER_1_9_1

The current composite version number of COMSTL.

#define _COMSTL_VER_MAJOR   1

The major version number of COMSTL.

This number is subject to increment when changes to COMSTL are so substantial as to require wholesale changes to application code.

#define _COMSTL_VER_MINOR   9

The minor version number of COMSTL.

This number is subject to increment when changes to COMSTL as so substantial as to require wholesale changes to application code.

#define _COMSTL_VER_REVISION   1

The revision version number of COMSTL.

#define comstl_destroy_instance	(	t,
		_type,
		p		)	STLSOFT_DESTROY_INSTANCE(t, _type, p)

[DEPRECATED] Destroys the given instance p of the given type (t and _type)

Deprecated:

This is heavily deprecated in favour of STLSOFT_DESTROY_INSTANCE().

#define comstl_gen_opaque

(

_htype

)

STLSOFT_GEN_OPAQUE(_htype)

[DEPRECATED] Generates an opaque type with the name _htype

Deprecated:

This is heavily deprecated in favour of STLSOFT_GEN_OPAQUE().

#define COMSTL_INCL_H_COMSTL

Defined for backward-compatiblity.

This is the old header include guard, from when comstl.h was in the STLSoft root include directory

#define comstl_ns_qual

(

x

)

::comstl::x

Qualifies with comstl:: if COMSTL is using namespaces or, if not, does not qualify.

#define comstl_ns_qual_std

(

x

)

::std::x

Qualifies with std:: if COMSTL is being translated in the context of the standard library being within the std namespace or, if not, does not qualify.

#define comstl_ns_using

(

x

)

using ::comstl::x;

Declares a using directive (with respect to comstl) if COMSTL is using namespaces or, if not, does nothing.

#define comstl_ns_using_std

(

x

)

using ::std::x;

Declares a using directive (with respect to std) if COMSTL is being translated in the context of the standard library being within the std namespace or, if not, does nothing.