Freigeben über


ActivateActCtx-Funktion (winbase.h)

Die ActivateActCtx-Funktion aktiviert den angegebenen Aktivierungskontext. Dazu wird der angegebene Aktivierungskontext an den Anfang des Aktivierungsstapels gepusht. Der angegebene Aktivierungskontext ist somit dem aktuellen Thread und allen entsprechenden parallelen API-Funktionen zugeordnet.

Syntax

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

Parameter

[in] hActCtx

Handle für eine ACTCTX-Struktur , die Informationen zum Aktivierungskontext enthält, der aktiviert werden soll.

[out] lpCookie

Zeiger auf eine ULONG_PTR , die als Cookie fungiert und einen bestimmten aktivierten Aktivierungskontext eindeutig identifiziert.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird TRUE zurückgegeben. Andernfalls wird FALSE 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

Der parameter lpCookie wird später an DeactivateActCtx übergeben. Dadurch wird die Kopplung von Aufrufen von ActivateActCtx und DeactivateActCtx überprüft und sichergestellt, dass der entsprechende Aktivierungskontext deaktiviert wird. Dies geschieht, weil die Deaktivierung von Aktivierungskontexten in der umgekehrten Reihenfolge der Aktivierung erfolgen muss.

Die Aktivierung von Aktivierungskontexten kann als Push eines Aktivierungskontexts auf einen Stapel von Aktivierungskontexten verstanden werden. Der Aktivierungskontext, den Sie über diese Funktion aktivieren, leitet jede Bindung an DLLs, Fensterklassen, COM-Server, Typbibliotheken und Mutexes für alle von Ihnen aufgerufenen parallelen APIs um.

Das oberste Element eines Aktivierungskontextstapels ist der aktive Standardaktivierungskontext des aktuellen Threads. Wenn ein Nullaktivierungskontexthandle auf den Stapel gepusht und dadurch aktiviert wird, überschreiben die Standardeinstellungen im ursprünglichen Manifest alle Aktivierungskontexte, die niedriger im Stapel sind.

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 (Windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

ACTCTX

DeactivateActCtx