AvRtDeleteThreadOrderingGroup 函式 (avrt.h)

刪除呼叫端所建立的指定線程排序群組。 它會清除線程排序群組的資源，包括內容資訊，並傳回。

語法

AVRTAPI BOOL AvRtDeleteThreadOrderingGroup(
  [in] HANDLE Context
);

參數

[in] Context

內容句柄。 建立群組時 ，AvRtCreateThreadThreadOrderingGroup 函式會傳回此句柄。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 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
程式庫	Avrt.lib
Dll	Avrt.dll

另請參閱

線程排序服務