AvRtWaitOnThreadOrderingGroup 函式 (avrt.h)

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

語法

AVRTAPI BOOL AvRtWaitOnThreadOrderingGroup(
  [in] HANDLE Context
);

參數

[in] Context

內容句柄。 AvRtCreateThreadOrderingGroup 或 AvRtJoinThreadOrderingGroup 函式會傳回此句柄。

傳回值

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

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

另請參閱

線程排序服務