Função TcDeleteFlow (traffic.h)
A função TcDeleteFlow exclui um fluxo que foi adicionado com a função TcAddFlow . Os clientes devem excluir todos os filtros associados a um fluxo antes de excluí-lo; caso contrário, um erro será retornado e a função não excluirá o fluxo.
Os clientes de controle de tráfego que registraram um manipulador DeleteFlowComplete (um mecanismo para permitir que o controle de tráfego chame a função de retorno de chamada ClDeleteFlowComplete para alertar os clientes sobre exclusões de fluxo concluídas) podem esperar um valor retornado de ERROR_SIGNAL_PENDING.
Sintaxe
ULONG TcDeleteFlow(
[in] HANDLE FlowHandle
);
Parâmetros
[in] FlowHandle
Identificador para o fluxo, conforme recebido de uma chamada anterior para a função TcAddFlow .
Retornar valor
| Código de retorno | Descrição |
|---|---|
|
A função executada sem erros. |
|
A função está sendo executada de forma assíncrona; o cliente será chamado novamente por meio da função ClDeleteFlowComplete exposta pelo cliente quando o fluxo tiver sido adicionado ou quando o processo for concluído. |
|
O identificador de fluxo é inválido ou NULL. |
|
A ação executada no fluxo por uma chamada de função anterior para TcModifyFlow, TcDeleteFlow ou TcAddFlow ainda não foi concluída. |
|
Existe pelo menos um filtro associado a esse fluxo. |
Comentários
Se a função TcDeleteFlow retornar ERROR_SIGNAL_PENDING, a função ClDeleteFlowComplete será chamada em um thread diferente do thread que chamou a função TcDeleteFlow .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | traffic.h |
| Biblioteca | Traffic.lib |
| DLL | Traffic.dll |