Ler em inglês

Compartilhar via

Função TcQueryInterface (traffic.h)

  • Artigo

A função TcQueryInterface consulta o controle de tráfego para parâmetros relacionados por interface. Um parâmetro de controle de tráfego é consultado fornecendo seu GUID (identificador global exclusivo). Definir o parâmetro NotifyChange como TRUE habilita a notificação de evento no GUID especificado, após o qual os eventos de notificação são enviados a um cliente sempre que o parâmetro consultado é alterado. GUIDs para os quais os clientes podem solicitar notificação são encontrados na entrada GUID ; a coluna intitulada "Notificação" indica quais GUIDs estão disponíveis para notificação.

Sintaxe

ULONG TcQueryInterface(
  [in]      HANDLE  IfcHandle,
  [in]      LPGUID  pGuidParam,
  [in]      BOOLEAN NotifyChange,
  [in, out] PULONG  pBufferSize,
  [out]     PVOID   Buffer
);

Parâmetros

[in] IfcHandle

Identificador associado à interface a ser consultada. Esse identificador é obtido por uma chamada anterior para a função TcOpenInterface .

[in] pGuidParam

Ponteiro para o GUID (identificador global exclusivo) que corresponde ao parâmetro de controle de tráfego que está sendo consultado.

[in] NotifyChange

Usado para solicitar notificações do controle de tráfego para o parâmetro que está sendo consultado. Se TRUE, o controle de tráfego notificará o cliente, por meio da função ClNotifyHandler , após alterações no parâmetro correspondente ao GUID fornecido em pGuidParam. As notificações estão desativadas por padrão.

[in, out] pBufferSize

Indica o tamanho do buffer, em bytes. Para entrada, esse valor é o tamanho do buffer alocado pelo chamador. Para saída, esse valor é o tamanho real do buffer, em bytes, usado pelo controle de tráfego.

[out] Buffer

Ponteiro para um buffer alocado pelo cliente no qual os dados retornados serão gravados.

Retornar valor

Observe que, em relação a um estado de notificação solicitado, apenas um valor retornado de NO_ERROR resultará no aplicativo do estado de notificação solicitado. Se um valor retornado diferente de NO_ERROR for retornado de uma chamada para a função TcQueryInterface , a alteração solicitada no estado de notificação não será aceita.

Código de retorno Descrição
NO_ERROR
 A função executada sem erros.
ERROR_INVALID_HANDLE
 Identificador de interface inválido.
ERROR_INVALID_PARAMETER
 Parâmetro nulo ou inválido.
ERROR_INSUFFICIENT_BUFFER
 O buffer é muito pequeno para armazenar os resultados.
ERROR_NOT_SUPPORTED
 Não há suporte para a consulta para o GUID fornecido na interface fornecida.
ERROR_WMI_GUID_NOT_FOUND
 O dispositivo não se registrou para esse GUID.
ERROR_WMI_INSTANCE_NOT_FOUND
 O nome da instância não foi encontrado, provavelmente porque a interface está em processo de fechamento.

Comentários

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

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

Confira também

ClNotifyHandler

TcEnumerateInterfaces

TcRegisterClient