CoInitializeEx.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

CoInitializeEx (OLE32.@)

SYNOPSIS

HRESULT CoInitializeEx
 (
  LPVOID lpReserved,
  DWORD  dwCoInit
 )

DESCRIPTION

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.

SEE ALSO

CoUninitialize

IMPLEMENTATION

Defined in "compobj_private.h".

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

Debug channel "ole".