CoDecrementMTAUsage-Funktion (combaseapi.h)
Gibt das Inkrement frei, das durch einen vorherigen Aufruf der Funktion CoIncrementMTAUsage vorgenommen wurde.
Syntax
HRESULT CoDecrementMTAUsage(
[in] CO_MTA_USAGE_COOKIE Cookie
);
Parameter
[in] Cookie
Eine PVOID-Variable , die durch einen vorherigen Aufruf der CoIncrementMTAUsage-Funktion festgelegt wurde.
Rückgabewert
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Cookie muss ein gültiger Wert sein, der von einem erfolgreichen vorherigen Aufruf der Funktion CoIncrementMTAUsage zurückgegeben wurde. Wenn die Gesamtanzahl der MTA-Nutzung 0 erreicht, einschließlich sowohl über diese API als auch über die Funktionen CoInitializeEx und CoUninitialize , gibt das System Ressourcen frei, die mit der MTA-Unterstützung zusammenhängen.
Sie können CoIncrementMTAUsage aus einem Thread und CoDecrementMTAUsage aus einem anderen aufrufen, solange ein zuvor von CoIncrementMTAUsage zurückgegebenes Cookie an CoDecrementMTAUsage übergeben wird.
Rufen Sie CoDecrementMTAUsage während des Herunterfahrens des Prozesses oder innerhalb von dllmain nicht auf. Sie können CoDecrementMTAUsage vor dem Aufruf aufrufen, um den Herunterfahrensprozess zu starten.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | combaseapi.h |
Bibliothek | Ole32.lib |
DLL | Ole32.dll |