Share via

AvRtDeleteThreadOrderingGroup 関数 (avrt.h)

  • [アーティクル]

呼び出し元によって作成された指定されたスレッド順序付けグループを削除します。 コンテキスト情報を含むスレッド順序付けグループのリソースをクリーンアップし、 を返します。

構文

AVRTAPI BOOL AvRtDeleteThreadOrderingGroup(
  [in] HANDLE Context
);

パラメーター

[in] Context

コンテキスト ハンドル。 このハンドルは、グループの作成時に AvRtCreateThreadOrderingGroup 関数によって返されます。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

この関数は、スレッド順序付けグループの親スレッドによってのみ正常に呼び出すことができます。 親スレッド以外のスレッドがこの関数を呼び出すと、関数は最後のエラー コード ERROR_INVALID_FUNCTIONで失敗します。

親スレッドがタイムアウトし、この関数の呼び出しを試みると、関数は最後のエラー コード ERROR_INVALID_PARAMETERで失敗します。

例

次のコードは、スレッド順序付けグループを削除します。

#include <windows.h>
#include <avrt.h>
#include <stdio.h>

#pragma comment(lib, "Avrt.lib")

HANDLE Context;

int main( void )
{
    if(!AvRtDeleteThreadOrderingGroup(Context))
    {
        printf("Error deleting group (%d)\n", GetLastError());
        return 1;
    }

    return 0;
}

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー avrt.h
Library Avrt.lib
[DLL] Avrt.dll

こちらもご覧ください

スレッド順序付けサービス