Funzione CreateActCtxA (winbase.h)
La funzione CreateActCtx crea un contesto di attivazione.
Sintassi
HANDLE CreateActCtxA(
[in, out] PCACTCTXA pActCtx
);
Parametri
[in, out] pActCtx
Puntatore a una struttura ACTCTX che contiene informazioni sul contesto di attivazione da creare.
Valore restituito
Se la funzione ha esito positivo, restituisce un handle al contesto di attivazione restituito. In caso contrario, restituisce INVALID_HANDLE_VALUE.
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
Impostare eventuali bit non definiti in dwFlags di ACTCTX su 0. Se i bit non definiti non sono impostati su 0, la chiamata a CreateActCtx che crea il contesto di attivazione ha esito negativo e restituisce un codice di errore di parametro non valido. L'handle restituito da CreateActCtx viene passato in una chiamata a ActivateActCtx per attivare il contesto per il thread corrente.
Nota
L'intestazione winbase.h definisce CreateActCtx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |