Funzione ActivateActCtx (winbase.h)

La funzione ActivateActCtx attiva il contesto di attivazione specificato. Esegue questa operazione eseguendo il push del contesto di attivazione specificato all'inizio dello stack di attivazione. Il contesto di attivazione specificato è quindi associato al thread corrente e alle funzioni API side-by-side appropriate.

Sintassi

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

Parametri

[in] hActCtx

Gestire una struttura ACTCTX che contiene informazioni sul contesto di attivazione che deve essere reso attivo.

[out] lpCookie

Puntatore a un ULONG_PTR che funziona come cookie, identificando in modo univoco un contesto di attivazione specifico e attivato.

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

Il parametro lpCookie viene passato successivamente a DeactivateActCtx, che verifica l'associazione di chiamate a ActivateActCtx e DisattivaActCtx e garantisce che il contesto di attivazione appropriato venga disattivato. Questa operazione viene eseguita perché la disattivazione dei contesti di attivazione deve verificarsi nell'ordine inverso di attivazione.

L'attivazione dei contesti di attivazione può essere compresa come push di un contesto di attivazione in uno stack di contesti di attivazione. Il contesto di attivazione attivato tramite questa funzione reindirizza qualsiasi associazione a DLL, classi di finestre, server COM, librerie di tipi e mutex per tutte le API side-by-side chiamate.

L'elemento principale di uno stack di contesto di attivazione è il contesto attivo e predefinito di attivazione del thread corrente. Se un handle di contesto di attivazione Null viene eseguito il push nello stack, attivandolo, le impostazioni predefinite nel manifesto originale eseguono l'override di tutti i contesti di attivazione inferiori nello stack.

Requisiti

Vedere anche

ACTCTX

DisattivaActCtx