Partilhar via

Função TcModifyFlow (traffic.h)

  • Artigo

A função TcModifyFlow modifica um fluxo existente. Ao chamar TcModifyFlow, novos parâmetros Flowspec e quaisquer objetos de controle de tráfego devem ser preenchidos.

Os clientes de controle de tráfego que registraram um manipulador ModifyFlowComplete (um mecanismo para permitir que o controle de tráfego chame a função de retorno de chamada ClModifyFlowComplete para alertar os clientes sobre modificações de fluxo concluídas) podem esperar um valor retornado de ERROR_SIGNAL_PENDING.

Sintaxe

ULONG TcModifyFlow(
  [in] HANDLE       FlowHandle,
  [in] PTC_GEN_FLOW pGenericFlow
);

Parâmetros

[in] FlowHandle

Identificador para o fluxo, conforme recebido de uma chamada anterior para a função TcAddFlow .

[in] pGenericFlow

Ponteiro para uma descrição das modificações de fluxo.

Valor retornado

Código de retorno Descrição
NO_ERROR
 A função executada sem erros.
ERROR_SIGNAL_PENDING
 A função está sendo executada de forma assíncrona; o cliente será chamado novamente por meio da função ClModifyFlowComplete exposta pelo cliente quando o fluxo tiver sido adicionado ou quando o processo for concluído.
ERROR_INVALID_HANDLE
 O identificador de interface é inválido.
ERROR_NOT_ENOUGH_MEMORY
 O sistema está sem memória.
ERROR_NOT_READY
 A ação executada no fluxo por uma chamada de função anterior para TcAddFlow, TcModifyFlow ou TcDeleteFlow ainda não foi concluída.
ERROR_INVALID_PARAMETER
 Um parâmetro é inválido.
ERROR_INVALID_SERVICE_TYPE
 Um tipo de serviço intserv intserv não especificado ou inválido foi fornecido.
ERROR_INVALID_TOKEN_RATE
 Um valor TokenRate inválido ou não especificado foi fornecido.
ERROR_INVALID_PEAK_RATE
 O valor peakBandwidth é inválido.
ERROR_INVALID_SD_MODE
 O ShapeDiscardMode é inválido.
ERROR_INVALID_QOS_PRIORITY
 O valor de prioridade é inválido.
ERROR_INVALID_TRAFFIC_CLASS
 O valor da classe de tráfego é inválido.
ERROR_NO_SYSTEM_RESOURCES
 Não há recursos suficientes para acomodar o fluxo solicitado.
ERROR_TC_OBJECT_LENGTH_INVALID
 Comprimento inválido especificado para os objetos TC.
ERROR_INVALID_DIFFSERV_FLOW
 Aplica-se a fluxos Diffserv. Indica que o objeto QOS_DIFFSERV foi passado com um parâmetro inválido.
ERROR_DS_MAPPING_EXISTS
 Aplica-se a fluxos Diffserv. Indica que o QOS_DIFFSERV_RULE especificado em TC_GEN_FLOW já se aplica a um fluxo existente na interface.
ERROR_INVALID_SHAPE_RATE
 O QOS_SHAPING_RATE foi passado com um ShapeRate inválido.
ERROR_INVALID_DS_CLASS

QOS_DS_CLASS é inválido.
ERROR_NETWORK_UNREACHABLE
 O cabo de rede não está conectado ao adaptador.

Comentários

Se a função TcModifyFlow retornar ERROR_SIGNAL_PENDING, a função ClModifyFlowComplete será chamada em um thread diferente do thread que chamou a função TcModifyFlow .

Nota O uso da função TcModifyFlow requer privilégio administrativo.
 

Requisitos

   
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

Confira também

ClModifyFlowComplete

TcAddFlow

TcEnumerateFlows