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 |
|---|---|
|
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. |
|
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 |