Contatori di esplorazione
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.
In input, il membro szReturnPathBuffer contiene l'oggetto prestazioni predefinito e il contatore selezionati nella finestra di dialogo. Nell'output, il buffer contiene l'oggetto prestazioni e il contatore selezionati dall'utente. È anche possibile utilizzare il membro 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 .For an example that uses the PdhBrowseCounters function, see 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 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 fino a quando non si chiama PdhEnumObjects per aggiornare prima l'elenco degli oggetti prestazioni. Per un esempio che enumera oggetti e contatori, vedere Enumerating Process Objects.For an example that enumerates objects and counters, see Enumerating Process Objects.
Selezione dell'origine dati
È possibile usare PdhSelectDataSource insieme a 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.