Función ActivateActCtx (winbase.h)

La función ActivateActCtx activa el contexto de activación especificado. Para ello, inserta el contexto de activación especificado en la parte superior de la pila de activación. Por lo tanto, el contexto de activación especificado está asociado al subproceso actual y a las funciones de API en paralelo adecuadas.

Sintaxis

BOOL ActivateActCtx(
  [in]  HANDLE    hActCtx,
  [out] ULONG_PTR *lpCookie
);

Parámetros

[in] hActCtx

Identificador de una estructura ACTCTX que contiene información sobre el contexto de activación que se va a activar.

[out] lpCookie

Puntero a un ULONG_PTR que funciona como una cookie, identificando de forma única un contexto de activación específico activado.

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE. De lo contrario, devuelve FALSE.

Esta función establece errores que se pueden recuperar llamando a GetLastError. Para obtener un ejemplo, vea Recuperación del código de Last-Error. Para obtener una lista completa de los códigos de error, consulte Códigos de error del sistema.

Comentarios

El parámetro lpCookie se pasa posteriormente a DeactivateActCtx, que comprueba el emparejamiento de llamadas a ActivateActCtx y DeactivateActCtx y garantiza que se desactive el contexto de activación adecuado. Esto se hace porque la desactivación de contextos de activación debe producirse en el orden inverso de la activación.

La activación de contextos de activación se puede entender como insertar un contexto de activación en una pila de contextos de activación. El contexto de activación que activa a través de esta función redirige cualquier enlace a archivos DLL, clases de ventana, servidores COM, bibliotecas de tipos y exclusiones mutuas para cualquier API en paralelo a la que llame.

El elemento superior de una pila de contexto de activación es el contexto activo de activación predeterminada del subproceso actual. Si se inserta un identificador de contexto de activación null en la pila, lo que lo activa, la configuración predeterminada del manifiesto original invalida todos los contextos de activación inferiores en la pila.

Requisitos

Vea también

ACTCTX

DeactivateActCtx