Функция AvRtDeleteThreadOrderingGroup (avrt.h)

  • Статья

Удаляет указанную группу упорядочения потоков, созданную вызывающим объектом. Он очищает ресурсы для группы упорядочения потоков, включая сведения о контексте, и возвращает данные.

Синтаксис

AVRTAPI BOOL AvRtDeleteThreadOrderingGroup(
  [in] HANDLE Context
);

Параметры

[in] Context

Дескриптор контекста. Этот дескриптор возвращается функцией AvRtCreateThreadOrderingGroup при создании группы.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав 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
Header avrt.h
Библиотека Avrt.lib
DLL Avrt.dll

См. также раздел

Служба упорядочения потоков