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

Siehe auch

ACTCTX