ReleaseActCtx-Funktion (winbase.h)
Die ReleaseActCtx-Funktion verringert die Verweisanzahl des angegebenen Aktivierungskontexts.
Syntax
void ReleaseActCtx(
[in] HANDLE hActCtx
);
Parameter
[in] hActCtx
Handle an die ACTCTX-Struktur , die Informationen zum Aktivierungskontext enthält, für den die Verweisanzahl dekrementiert werden soll.
Rückgabewert
Diese Funktion gibt keinen Wert zurück. Bei erfolgreicher Fertigstellung wird die Anzahl der Aktivierungskontextreferenzen verringert. Der Empfänger des mit Verweis gezählten Objekts muss die Verweisanzahl verringern, wenn das Objekt nicht mehr benötigt wird.
Hinweise
Wenn die Verweisanzahl eines Aktivierungskontexts null ist, wird die Zuordnung der Aktivierungskontextstruktur aufgehoben. Aktivierungskontexte wurden nicht als Kernelobjekte implementiert, daher können Kernelhandlerfunktionen nicht für Aktivierungskontexte verwendet werden.
Wenn der Wert des hActCtx-Parameters ein NULL-Handle ist, bewirkt diese Funktion nichts, und es tritt keine Fehlerbedingung auf.
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 |