Compartilhar via


Função ReleaseActCtx (winbase.h)

A função ReleaseActCtx diminui a contagem de referência do contexto de ativação especificado.

Sintaxe

void ReleaseActCtx(
  [in] HANDLE hActCtx
);

Parâmetros

[in] hActCtx

Manipule para a estrutura ACTCTX que contém informações sobre o contexto de ativação para o qual a contagem de referência deve ser decrementada.

Retornar valor

Essa função não retorna um valor. Após a conclusão bem-sucedida, a contagem de referência de contexto de ativação é decrementada. O destinatário do objeto contado por referência deve diminuir a contagem de referência quando o objeto não for mais necessário.

Comentários

Quando a contagem de referência de um contexto de ativação se torna zero, a estrutura de contexto de ativação é desalocada. Os contextos de ativação não foram implementados como objetos kernel, portanto, as funções do manipulador de kernel não podem ser usadas para contextos de ativação.

Se o valor do parâmetro hActCtx for um identificador nulo, essa função não fará nada e nenhuma condição de erro ocorrerá.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

ACTCTX

AddRefActCtx