CreateActCtxW-Funktion (winbase.h)
Die CreateActCtx--Funktion erstellt einen Aktivierungskontext.
Syntax
HANDLE CreateActCtxW(
[in, out] PCACTCTXW pActCtx
);
Parameter
[in, out] pActCtx
Zeigen Sie auf eine ACTCTX- Struktur, die Informationen zum zu erstellenden Aktivierungskontext enthält.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird ein Handle für den zurückgegebenen Aktivierungskontext zurückgegeben. Andernfalls wird INVALID_HANDLE_VALUE zurückgegeben.
Diese Funktion legt Fehler fest, die durch Aufrufen GetLastErrorabgerufen werden können. Ein Beispiel finden Sie unter Abrufen des Last-Error Code-. Eine vollständige Liste der Fehlercodes finden Sie unter Systemfehlercodes.
Bemerkungen
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- fehl, der den Aktivierungskontext erstellt, 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.
Anmerkung
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 Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winbase.h (enthalten Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |