Função PdhSetDefaultRealTimeDataSource (pdh.h)

  • Artigo

Especifica a origem dos dados em tempo real.

Sintaxe

PDH_FUNCTION PdhSetDefaultRealTimeDataSource(
  [in] DWORD dwDataSourceId
);

Parâmetros

[in] dwDataSourceId

Fonte dos dados de desempenho. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
DATA_SOURCE_REGISTRY
 A fonte de dados é a interface do Registro. Esse é o padrão.
DATA_SOURCE_WBEM
 A fonte de dados é um provedor WMI.

Retornar valor

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema ou um código de erro PDH. Veja a seguir um valor possível.

Código de retorno Descrição
PDH_INVALID_ARGUMENT
 O parâmetro não é válido.

Comentários

O termo em tempo real , conforme usado na descrição dessa função, não implica o significado padrão do termo em tempo real. Em vez disso, ele descreve a coleção de dados de desempenho de uma fonte que fornece informações atuais (por exemplo, o registro ou um provedor WMI) em vez de um arquivo de log.

Se você quiser consultar dados em tempo real do WMI, deverá chamar PdhSetDefaultRealTimeDataSource para definir a fonte de dados padrão em tempo real. Você deve chamar essa função antes de chamar qualquer outra função de API PDH.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho pdh.h
Biblioteca Pdh.lib
DLL Pdh.dll

Confira também

PdhSelectDataSource