Función CoIncrementMTAUsage (combaseapi.h)

  • Artículo

Mantiene la compatibilidad con MTA activa cuando no se está ejecutando ningún subproceso de MTA.

Sintaxis

HRESULT CoIncrementMTAUsage(
  [out] CO_MTA_USAGE_COOKIE *pCookie
);

Parámetros

[out] pCookie

Dirección de una variable PVOID que recibe la cookie de la función CoDecrementMTAUsage o NULL si se produce un error en la llamada.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La función CoIncrementMTAUsage permite a los clientes crear trabajos de MTA y esperar a que finalicen antes de salir del proceso.

La función CoIncrementMTAUsage garantiza que el sistema no libere recursos relacionados con la compatibilidad con MTA, incluso si el recuento de subprocesos de MTA va a 0.

Si se ejecuta correctamente, llame solo a CoDecrementMTAUsage . En caso de error, no llame a la función CoDecrementMTAUsage .

No llames a CoIncrementMTAUsage durante el apagado del proceso o dentro de dllmain. Puede llamar a CoIncrementMTAUsage antes de la llamada para iniciar el proceso de apagado.

Puede llamar a CoIncrementMTAUsage desde un subproceso y CoDecrementMTAUsage desde otro siempre que una cookie devuelta previamente por CoIncrementMTAUsage se pase a CoDecrementMTAUsage.

CoIncrementMTAUsage crea el MTA, si el MTA aún no existe. CoIncrementMTAUsage coloca el subproceso actual en MTA, si el subproceso actual aún no está en un contenedor.

Puede usar CoIncrementMTAUsage cuando:

  • Quiere que un servidor mantenga activo el MTA incluso cuando todos los subprocesos de trabajo estén inactivos.
  • La implementación de la API requiere que COM se inicialice, pero no tiene información sobre si el subproceso actual ya está en un apartamento y no necesita que el subproceso actual vaya a un apartamento determinado.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado combaseapi.h
Library Ole32.lib
Archivo DLL Ole32.dll

Consulte también

CoDecrementMTAUsage