Função TcQueryFlowA (traffic.h)

Artigo
11/20/2024

A função TcQueryFlow consulta o controle de tráfego para o valor de um parâmetro de fluxo específico com base no nome do fluxo. O nome de um fluxo pode ser recuperado da função TcEnumerateFlows ou da função TcGetFlowName.

Sintaxe

ULONG TcQueryFlowA(
  [in]      LPSTR  pFlowName,
  [in]      LPGUID pGuidParam,
  [in, out] PULONG pBufferSize,
  [out]     PVOID  Buffer
);

Parâmetros

[in] pFlowName

Nome do fluxo que está sendo consultado.

[in] pGuidParam

Ponteiro para o GUID (identificador global exclusivo) que corresponde ao parâmetro de fluxo de interesse. Uma lista de GUIDs do controle de tráfego pode ser encontrada em guid.

[in, out] pBufferSize

Ponteiro para o tamanho do buffer fornecido pelo cliente ou o número de bytes usados pelo controle de tráfego. Para entrada, aponta para o tamanho de buffer, em bytes. Para saída, aponta para a quantidade real de espaço em buffer gravado com dados de parâmetro de fluxo retornados, em bytes.

[out] Buffer

Ponteiro para o buffer fornecido pelo cliente no qual o parâmetro de fluxo retornado é gravado.

Valor de retorno

Código de retorno	Descrição
NO_ERROR	A função executada sem erros.
ERROR_INVALID_PARAMETER	Um parâmetro é inválido.
ERROR_INSUFFICIENT_BUFFER	O buffer fornecido é muito pequeno para conter os resultados.
ERROR_NOT_SUPPORTED	Não há suporte para o GUID solicitado.
ERROR_WMI_GUID_NOT_FOUND	O dispositivo não se registrou para este GUID.
ERROR_WMI_INSTANCE_NOT_FOUND	O nome da instância não foi encontrado, provavelmente porque o fluxo ou a interface está em processo de fechamento.

Observações

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

Nota

O cabeçalho traffic.h define TcQueryFlow 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

Consulte também

guid do

TcEnumerateFlows

TcGetFlowName

Partilhar via