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 |