Función OleInitialize (ole2.h)

  • Artículo

Inicializa la biblioteca COM en el apartamento actual, identifica el modelo de simultaneidad como un solo subproceso (STA) y habilita la funcionalidad adicional descrita en la sección Comentarios a continuación. Las aplicaciones deben inicializar la biblioteca COM para poder llamar a funciones de biblioteca COM distintas de CoGetMalloc y funciones de asignación de memoria.

Sintaxis

HRESULT OleInitialize(
  [in] LPVOID pvReserved
);

Parámetros

[in] pvReserved

Este parámetro está reservado y debe ser NULL.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles incluyen lo siguiente.

Código devuelto Descripción
S_FALSE
 La biblioteca COM ya está inicializada en este apartamento.
OLE_E_WRONGCOMPOBJ
 Las versiones de COMPOBJ.DLL y de OLE2.DLL en su equipo son incompatibles entre sí.
RPC_E_CHANGED_MODE
 Una llamada anterior a CoInitializeEx especificó el modelo de simultaneidad para este apartamento como apartamento multiproceso (MTA). Esto también podría significar que se produjo un cambio de un apartamento de subproceso neutro a un solo apartamento subproceso.

Comentarios

Las aplicaciones que usan la siguiente funcionalidad deben llamar a OleInitialize antes de llamar a cualquier otra función de la biblioteca COM:

  • Portapapeles
  • Arrastrar y colocar
  • Vinculación e inserción de objetos (OLE)
  • Activación local
OleInitialize llama a CoInitializeEx internamente para inicializar la biblioteca COM en el apartamento actual. Dado que las operaciones OLE no son seguras para subprocesos, OleInitialize especifica el modelo de simultaneidad como apartamento de un solo subproceso.

Una vez establecido el modelo de simultaneidad de un apartamento, no se puede cambiar. Se producirá un error en una llamada a OleInitialize en un apartamento que se inicializó previamente como multiproceso y devolverá RPC_E_CHANGED_MODE.

Debe inicializar la biblioteca COM en un apartamento antes de llamar a cualquiera de las funciones de biblioteca excepto CoGetMalloc, para obtener un puntero al asignador estándar y las funciones de asignación de memoria.

Normalmente, la biblioteca COM se inicializa en un apartamento solo una vez. Las llamadas posteriores se realizarán correctamente, siempre y cuando no intenten cambiar el modelo de simultaneidad del apartamento, pero devolverán S_FALSE. Para cerrar correctamente la biblioteca COM, cada llamada correcta a OleInitialize, incluidas las que devuelven S_FALSE, debe equilibrarse mediante una llamada correspondiente a OleUninitialize.

Dado que no hay ninguna manera de controlar el orden en el que los servidores en proceso se cargan o descargan, no llame a OleInitialize ni OleUninitialize desde la función DllMain .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ole2.h
Library Ole32.lib
Archivo DLL Ole32.dll
Conjunto de API ext-ms-win-com-ole32-l1-1-0 (introducido en Windows 8)

Consulte también

CoInitializeEx

OleInitialize

OleUninitialize