共用方式為


AvRtWaitOnThreadOrderingGroup 函式 (avrt.h)

讓線程排序群組的用戶端線程等到應該執行為止。

語法

AVRTAPI BOOL AvRtWaitOnThreadOrderingGroup(
  [in] HANDLE Context
);

參數

[in] Context

內容句柄。 AvRtCreateThreadOrderingGroupAvRtJoinThreadOrderingGroup 函式會傳回此句柄。

傳回值

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

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

當此函式傳回時,線程應該會在期間內完成其處理,然後再次呼叫函式。

如果線程在建立群組時,在父線程指定的逾時間隔期間無法完成其處理,則會從線程排序群組中刪除。 因此,當線程完成其處理迴圈時,下一次對 AvRtWaitOnThreadOrderingGroup 的呼叫會失敗,最後一個錯誤碼會設定為 ERROR_ACCESS_DENIED。

如果在等候期間刪除線程排序群組,此函式最終會逾時並傳回ERROR_ACCESS_DENIED。

範例

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

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

HANDLE Context;

int main( void )
{
    while(AvRtWaitOnThreadOrderingGroup(Context))
    {
        // Complete task for this period.
    }

return 0;
}

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 avrt.h
程式庫 Avrt.lib
Dll Avrt.dll

另請參閱

線程排序服務