Función DeactivateActCtx (winbase.h)

  • Artículo

La función DeactivateActCtx desactiva el contexto de activación correspondiente a la cookie especificada.

Sintaxis

BOOL DeactivateActCtx(
  [in] DWORD     dwFlags,
  [in] ULONG_PTR ulCookie
);

Parámetros

[in] dwFlags

Marcas que indican cómo se va a producir la desactivación.

Value Significado
0
 Si se establece este valor y la cookie especificada en el parámetro ulCookie se encuentra en el marco superior de la pila de activación, el contexto de activación se extrae de la pila y, por tanto, se desactiva.

Si se establece este valor y la cookie especificada en el parámetro ulCookie no está en el marco superior de la pila de activación, esta función busca en la pila la cookie.

Si se encuentra la cookie, se produce una excepción de STATUS_SXS_EARLY_DEACTIVATION.

Si no se encuentra la cookie, se produce una excepción de STATUS_SXS_INVALID_DEACTIVATION.

Este valor debe especificarse en la mayoría de los casos.
DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION
 Si se establece este valor y la cookie especificada en el parámetro ulCookie se encuentra en el marco superior de la pila de activación, la función devuelve un código de error ERROR_INVALID_PARAMETER. Llame a GetLastError para obtener este código.

Si se establece este valor y la cookie no está en la pila de activación, se producirá una excepción de STATUS_SXS_INVALID_DEACTIVATION.

Si se establece este valor y la cookie se encuentra en un marco inferior de la pila de activación, todos los fotogramas hasta y el marco en el que se encuentra la cookie se extrae de la pila.

[in] ulCookie

El ULONG_PTR que se pasó a la llamada a ActivateActCtx. Este valor se usa como una cookie para identificar un contexto de activación activado específico.

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

La desactivación de contextos de activación debe producirse en el orden inverso de la activación. Se puede entender como extraer un contexto de activación de una pila.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

ActivateActCtx