Função TcSetFlowA (traffic.h)

Artigo
11/20/2024

A função TcSetFlow define parâmetros individuais para um determinado fluxo.

Sintaxe

ULONG TcSetFlowA(
  [in] LPSTR  pFlowName,
  [in] LPGUID pGuidParam,
  [in] ULONG  BufferSize,
  [in] PVOID  Buffer
);

Parâmetros

[in] pFlowName

Nome do fluxo que está sendo definido. O valor desse parâmetro é obtido por uma chamada anterior para a função TcEnumerateFlows ou a função TcGetFlowName.

[in] pGuidParam

Ponteiro para o GUID (identificador global exclusivo) que corresponde ao parâmetro a ser definido. Uma lista de GUIDs disponíveis pode ser encontrada em GUID.

[in] BufferSize

Tamanho do buffer fornecido pelo cliente, em bytes.

[in] Buffer

Ponteiro para um buffer fornecido pelo cliente. O buffer deve conter o valor para o qual o parâmetro de controle de tráfego fornecido em pGuidParam deve ser definido.

Valor de retorno

A função TcSetFlow tem os seguintes valores retornados.

Código de retorno	Descrição
NO_ERROR	A função executada sem erros.
ERROR_NOT_READY	O fluxo está sendo modificado no momento.
ERROR_NOT_ENOUGH_MEMORY	O tamanho do buffer era insuficiente para o GUID.
ERROR_INVALID_PARAMETER	Parâmetro inválido.
ERROR_NOT_SUPPORTED	Não há suporte para a configuração do GUID para o fluxo fornecido.
ERROR_WMI_INSTANCE_NOT_FOUND	O nome da instância não foi encontrado, provavelmente devido ao fluxo ou à interface estar em processo de fechamento.
ERROR_WMI_GUID_NOT_FOUND	O dispositivo não se registrou para este GUID.

Observações

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

Nota

O cabeçalho traffic.h define TcSetFlow como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	traffic.h
de DLL	Traffic.dll

Partilhar via