Navigazione dei contatori

Per visualizzare una finestra di dialogo che elenca gli oggetti prestazioni e i contatori definiti nel computer, chiamare la funzione PdhBrowseCounters. La finestra di dialogo consente all'utente di esplorare e selezionare i contatori delle prestazioni. Utilizzare la struttura PDH_BROWSE_DLG_CONFIG per specificare la configurazione della finestra di dialogo. Ad esempio, è possibile configurare la finestra di dialogo per restituire una selezione o più selezioni.

Quando viene fornito l'input, il membro szReturnPathBuffer contiene l'oggetto delle prestazioni e il contatore predefiniti selezionati nella finestra di dialogo. All'output, il buffer contiene l'oggetto delle prestazioni e il contatore selezionati dall'utente. È anche possibile utilizzare il rappresentante pCallBack per specificare una funzione di callback per elaborare i nomi dei contatori restituiti dalla finestra di dialogo.

Si noti che questa finestra di dialogo può restituire PDH_DIALOG_CANCELLED se bSingleCounterPerDialog è false e l'utente fa clic sul pulsante Chiudi, quindi la gestione degli errori dovrà tenere conto di questo.

Per un esempio che usa la funzione PdhBrowseCounters, vedere Browsing Performance Counters.

Per recuperare un elenco di oggetti prestazioni nel computer, è anche possibile chiamare la funzione PdhEnumObjects. Per recuperare un elenco di contatori e istanze per un oggetto delle prestazioni, chiamare la funzione PdhEnumObjectItems. È anche possibile usare queste funzioni per identificare gli oggetti prestazioni e i contatori contenuti in un file di log. Le chiamate ripetute a PdhEnumObjectItems restituiranno lo stesso elenco di contatori e istanze finché non si chiama PdhEnumObjects per aggiornare prima l'elenco di oggetti prestazioni. Per un esempio che enumera oggetti e contatori, vedere Enumerazione degli Oggetti di Processo.

Selezione dell'origine dati

È possibile usare PdhSelectDataSource in combinazione con PdhBrowseCounters per richiedere all'utente di selezionare se l'origine dati è in tempo reale o da un file di log e, se si tratta di un file di log, il relativo nome. Se non si desidera visualizzare la finestra di dialogo origine dati, è possibile chiamare PdhSelectDataSource per visualizzare solo il catalogo del browser file. A tale scopo, specificare PDH_FLAGS_FILE_BROWSER_ONLY come secondo parametro della chiamata a PdhSelectDataSource.