CoDecrementMTAUsage 関数 (combaseapi.h)
CoIncrementMTAUsage 関数の前回の呼び出しによって行われたインクリメントを解放します。
構文
HRESULT CoDecrementMTAUsage(
[in] CO_MTA_USAGE_COOKIE Cookie
);
パラメーター
[in] Cookie
CoIncrementMTAUsage 関数の以前の呼び出しによって設定された PVOID 変数。
戻り値
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
注釈
Cookie は、 CoIncrementMTAUsage 関数の以前の呼び出しが成功した場合に返される有効な値である必要があります。 この API と CoInitializeEx 関数と CoUninitialize 関数の両方を通じて、MTA の使用量の全体的な数が 0 に達すると、MTA サポートに関連するリソースが解放されます。
CoIncrementMTAUsage によって以前に返された Cookie が CoDecrementMTAUsage に渡されている限り、あるスレッドから CoIncrementMTAUsage を呼び出し、別のスレッドから CoDecrementMTAUsage を呼び出すことができます。
プロセスのシャットダウン中や dllmain 内で CoDecrementMTAUsage を 呼び出さないでください。 呼び出しの前に CoDecrementMTAUsage を呼び出して、シャットダウン プロセスを開始できます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | combaseapi.h |
| Library | Ole32.lib |
| [DLL] | Ole32.dll |