Compartilhar via


Função AvRtDeleteThreadOrderingGroup (avrt.h)

Exclui o grupo de ordenação de thread especificado criado pelo chamador. Ele limpa os recursos para o grupo de ordenação de threads, incluindo as informações de contexto, e retorna.

Sintaxe

AVRTAPI BOOL AvRtDeleteThreadOrderingGroup(
  [in] HANDLE Context
);

Parâmetros

[in] Context

Um identificador de contexto. Esse identificador é retornado pela função AvRtCreateThreadOrderingGroup ao criar o grupo.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Essa função só pode ser chamada com êxito pelo thread pai do grupo de ordenação de threads. Se um thread diferente do thread pai chamar essa função, a função falhará com um último código de erro de ERROR_INVALID_FUNCTION.

Se o thread pai atingir o tempo limite e tentar chamar essa função, a função falhará com um último código de erro de ERROR_INVALID_PARAMETER.

Exemplos

O código a seguir exclui um grupo de ordenação de threads.

#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;
}

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho avrt.h
Biblioteca Avrt.lib
DLL Avrt.dll

Confira também

Serviço de Ordenação de Threads