Condividi tramite


Funzione DisattivaActCtx (winbase.h)

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.

[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