CoDecrementMTAUsage-Funktion (combaseapi.h)

  • Artikel

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

Weitere Informationen

CoIncrementMTAUsage