Funzione DisattivaActCtx (winbase.h)

Articolo
08/27/2023

La funzione DisattivaActCtx disattiva il contesto di attivazione corrispondente al cookie specificato.

Sintassi

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

Parametri

[in] dwFlags

Flag che indicano come si verifica la disattivazione.

Valore	Significato
0	Se questo valore è impostato e il cookie specificato nel parametro ulCookie si trova nel frame superiore dello stack di attivazione, il contesto di attivazione viene rimosso dallo stack e quindi disattivato. Se questo valore è impostato e il cookie specificato nel parametro ulCookie non si trova nel frame superiore dello stack di attivazione, questa funzione cerca lo stack per il cookie. Se il cookie viene trovato, viene generata un'eccezione STATUS_SXS_EARLY_DEACTIVATION. Se il cookie non viene trovato, viene generata un'eccezione STATUS_SXS_INVALID_DEACTIVATION. Questo valore deve essere specificato nella maggior parte dei casi.
DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION	Se questo valore è impostato e il cookie specificato nel parametro ulCookie si trova nel frame superiore dello stack di attivazione, la funzione restituisce un codice di errore ERROR_INVALID_PARAMETER. Chiamare GetLastError per ottenere questo codice. Se questo valore è impostato e il cookie non si trova nello stack di attivazione, verrà generata un'eccezione STATUS_SXS_INVALID_DEACTIVATION. Se questo valore è impostato e il cookie si trova in un frame inferiore dello stack di attivazione, tutti i fotogrammi vengono inseriti nello stack.

Valore

Significato

0

Se questo valore è impostato e il cookie specificato nel parametro ulCookie si trova nel frame superiore dello stack di attivazione, il contesto di attivazione viene rimosso dallo stack e quindi disattivato.

Se questo valore è impostato e il cookie specificato nel parametro ulCookie non si trova nel frame superiore dello stack di attivazione, questa funzione cerca lo stack per il cookie.

Se il cookie viene trovato, viene generata un'eccezione STATUS_SXS_EARLY_DEACTIVATION.

Se il cookie non viene trovato, viene generata un'eccezione STATUS_SXS_INVALID_DEACTIVATION.

Questo valore deve essere specificato nella maggior parte dei casi.

DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION

Se questo valore è impostato e il cookie specificato nel parametro ulCookie si trova nel frame superiore dello stack di attivazione, la funzione restituisce un codice di errore ERROR_INVALID_PARAMETER. Chiamare GetLastError per ottenere questo codice.

Se questo valore è impostato e il cookie non si trova nello stack di attivazione, verrà generata un'eccezione STATUS_SXS_INVALID_DEACTIVATION.

Se questo valore è impostato e il cookie si trova in un frame inferiore dello stack di attivazione, tutti i fotogrammi vengono inseriti nello stack.

[in] ulCookie

Il ULONG_PTR passato alla chiamata a ActivateActCtx. Questo valore viene usato come cookie per identificare un contesto di attivazione attivato specifico.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE. In caso contrario, restituisce FALSE.

Questa funzione imposta errori che possono essere recuperati chiamando GetLastError. Per un esempio, vedere Recupero del codice Last-Error. Per un elenco completo dei codici di errore, vedere Codici di errore di sistema.

Commenti

La disattivazione dei contesti di attivazione deve verificarsi nell'ordine inverso dell'attivazione. Può essere compreso come comparsa di un contesto di attivazione da uno stack.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

ActivateActCtx

Share via