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

こちらもご覧ください

CoIncrementMTAUsage