CoInitializeEx3w

Usage

Overview

Initializes the COM libraries.

Params

lpReserved [In] Pointer to IMalloc interface (obsolete, should be NULL).

dwCoInit [In] One or more flags from the COINIT enumeration. See notes.

Returns

S_OK if successful, S_FALSE if this function was called already. RPC_E_CHANGED_MODE if a previous call to CoInitializeEx specified another threading model.

Notes

The behavior used to set the IMalloc used for memory management is obsolete. The dwCoInit parameter must specify one of the following apartment threading models:

COINIT_APARTMENTTHREADED - A single-threaded apartment (STA).

COINIT_MULTITHREADED - A multi-threaded apartment (MTA).

The parameter may also specify zero or more of the following flags:

COINIT_DISABLE_OLE1DDE - Don't use DDE for OLE1 support.

COINIT_SPEED_OVER_MEMORY - Trade memory for speed.

Implementation

Declared in "compobj_private.h".

Implemented in "dlls/ole32/compobj.c".

Debug channel "ole".