CreateActCtxA-Funktion (winbase.h)
Die CreateActCtx-Funktion erstellt einen Aktivierungskontext.
Syntax
HANDLE CreateActCtxA(
[in, out] PCACTCTXA pActCtx
);
Parameter
[in, out] pActCtx
Zeiger auf eine ACTCTX-Struktur , die Informationen zum zu erstellenden Aktivierungskontext enthält.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie ein Handle an den zurückgegebenen Aktivierungskontext zurück. Andernfalls wird INVALID_HANDLE_VALUE zurückgegeben.
Diese Funktion legt Fehler fest, die durch Aufrufen von GetLastError abgerufen werden können. Ein Beispiel finden Sie unter Abrufen des Last-Error Codes. Eine vollständige Liste der Fehlercodes finden Sie unter Systemfehlercodes.
Hinweise
Legen Sie alle nicht definierten Bits in dwFlags von ACTCTX auf 0 fest. Wenn nicht definierte Bits nicht auf 0 festgelegt sind, schlägt der Aufruf von CreateActCtx , der den Aktivierungskontext erstellt, fehl und gibt einen ungültigen Parameterfehlercode zurück. Das von CreateActCtx zurückgegebene Handle wird in einem Aufruf von ActivateActCtx übergeben, um den Kontext für den aktuellen Thread zu aktivieren.
Hinweis
Der winbase.h-Header definiert CreateActCtx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |