Função PdhSetDefaultRealTimeDataSource (pdh.h)
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 |
---|---|
|
A fonte de dados é a interface do Registro. Esse é o padrão. |
|
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 |
---|---|
|
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 |