struttura PDH_BROWSE_DLG_CONFIG_A (pdh.h)
La struttura PDH_BROWSE_DLG_CONFIG viene utilizzata dalla funzione PdhBrowseCounters per configurare la finestra di dialogo Sfoglia contatori prestazioni .
Sintassi
typedef struct _BrowseDlgConfig_A {
DWORD bIncludeInstanceIndex : 1;
DWORD bSingleCounterPerAdd : 1;
DWORD bSingleCounterPerDialog : 1;
DWORD bLocalCountersOnly : 1;
DWORD bWildCardInstances : 1;
DWORD bHideDetailBox : 1;
DWORD bInitializePath : 1;
DWORD bDisableMachineSelection : 1;
DWORD bIncludeCostlyObjects : 1;
DWORD bShowObjectBrowser : 1;
DWORD bReserved : 22;
HWND hWndOwner;
LPSTR szDataSource;
LPSTR szReturnPathBuffer;
DWORD cchReturnPathLength;
CounterPathCallBack pCallBack;
DWORD_PTR dwCallBackArg;
PDH_STATUS CallBackStatus;
DWORD dwDefaultDetailLevel;
LPSTR szDialogBoxCaption;
} PDH_BROWSE_DLG_CONFIG_A, *PPDH_BROWSE_DLG_CONFIG_A;
Members
bIncludeInstanceIndex
Se questo flag è TRUE, la finestra di dialogo include un numero di indice per i nomi di istanza duplicati. Ad esempio, se sono presenti due istanze cmd, l'elenco di istanze conterrà cmd e cmd#1. Se questo flag è FALSE, i nomi di istanza duplicati non conterranno un numero di indice.
bSingleCounterPerAdd
Se questo flag è TRUE, la finestra di dialogo restituisce un solo contatore. Se questo flag è FALSE, la finestra di dialogo può restituire più selezioni e sono consentite selezioni con caratteri jolly. I contatori selezionati vengono restituiti come stringa MULTI_SZ.
bSingleCounterPerDialog
Se questo flag è TRUE, la finestra di dialogo utilizza un pulsante OK e Annulla. La finestra di dialogo viene restituita quando l'utente fa clic su uno dei due pulsanti. Se questo flag è FALSE, la finestra di dialogo utilizza un pulsante Aggiungi e Chiudi. La finestra di dialogo viene chiusa quando l'utente fa clic sul pulsante Chiudi. È possibile fare clic sul pulsante Aggiungi più volte. Il pulsante Aggiungi sovrascrive gli elementi selezionati in precedenza con gli elementi attualmente selezionati.
bLocalCountersOnly
Se questo flag è TRUE, la finestra di dialogo consente all'utente di selezionare contatori solo dal computer locale (il percorso non conterrà un nome computer). Se questo flag è FALSE, l'utente può specificare un computer da cui selezionare i contatori. Il nome del computer anteporrà il prefisso al percorso del contatore, a meno che l'utente non selezioni Usa contatori computer locali.
bWildCardInstances
Se questo flag è TRUE e l'utente seleziona Tutte le istanze, il percorso del contatore includerà il carattere jolly per il campo dell'istanza.
Se questo flag è FALSE e l'utente seleziona Tutte le istanze, tutte le istanze attualmente trovate per tale oggetto verranno restituite in una stringa MULTI_SZ.
bHideDetailBox
Se questo flag è TRUE, il livello dettaglio viene rimosso dalla finestra di dialogo in modo che l'utente non possa modificare il livello di dettaglio dei contatori visualizzati nella finestra di dialogo. Il livello di dettaglio verrà fisso sul valore del membro dwDefaultDetailLevel .
Se questo flag è FALSE, viene visualizzato il livello Dettaglio nella finestra di dialogo, consentendo all'utente di modificare il livello di dettaglio dei contatori visualizzati.
Si noti che i contatori visualizzati saranno quelli il cui livello di dettaglio è minore o uguale alla selezione del livello di dettaglio corrente. Selezionando un livello di dettaglio della procedura guidata verranno visualizzati tutti i contatori e gli oggetti.
bInitializePath
Se questo flag è TRUE, la finestra di dialogo evidenzia il contatore e l'oggetto specificati in szReturnPathBuffer quando la finestra di dialogo viene visualizzata per la prima volta, anziché utilizzare il contatore e l'oggetto predefiniti specificati dal computer.
Se questo flag è FALSE, viene selezionato il contatore iniziale e l'oggetto utilizzando le informazioni predefinite sul contatore e sull'oggetto restituite dal computer.
bDisableMachineSelection
Se questo flag è TRUE, l'utente non può selezionare un computer da Seleziona contatori dal computer.
Se questo flag è FALSE, l'utente può selezionare un computer da Seleziona contatori dal computer. Si tratta del valore predefinito. L'elenco contiene il computer locale solo se non si chiama pdhConnectMachine per connettersi prima ad altri computer.
bIncludeCostlyObjects
Se questo flag è TRUE, l'elenco dei contatori conterrà anche dati costosi, ovvero i dati che richiedono una quantità relativamente elevata di tempo del processore o un sovraccarico di memoria da raccogliere.
Se questo flag è FALSE, l'elenco non conterrà contatori costosi. Si tratta del valore predefinito.
bShowObjectBrowser
Se questo flag è TRUE, nella finestra di dialogo sono elencati solo gli oggetti prestazioni. Quando l'utente seleziona un oggetto, la finestra di dialogo restituisce un percorso del contatore che include l'oggetto e i caratteri jolly per il nome e il contatore dell'istanza se l'oggetto è un oggetto a più istanze. Ad esempio, se l'oggetto "Process" è selezionato, la finestra di dialogo restituisce la stringa "\Process(*)*". Se l'oggetto è un singolo oggetto di istanza, il percorso contiene un carattere jolly solo per il contatore. Ad esempio, "\System*". È quindi possibile passare il percorso a PdhExpandWildCardPath per recuperare un elenco di percorsi effettivi per l'oggetto.
bReserved
hWndOwner
Handle della finestra per la proprietà del dialogo. Se NULL, il proprietario è il desktop.
szDataSource
Puntatore a una stringa con terminazione Null che specifica il nome del file di log da cui viene recuperato l'elenco di contatori. Se NULL, l'elenco dei contatori viene recuperato dal computer locale (o dal computer remoto, se specificato).
szReturnPathBuffer
Puntatore a un MULTI_SZ contenente i percorsi dei contatori selezionati.
Se bInitializePath è TRUE, è possibile utilizzare questo membro per specificare un percorso del contatore i cui componenti vengono utilizzati per evidenziare le voci nel computer, nell'oggetto, nel contatore e negli elenchi di istanze quando viene visualizzata per la prima volta la finestra di dialogo.
cchReturnPathLength
Dimensioni del buffer szReturnPathBuffer , in TCHAR. Se la funzione di callback rialloca un nuovo buffer, deve anche aggiornare questo valore.
pCallBack
Puntatore alla funzione di callback che elabora la selezione dell'utente. Per altre informazioni, vedere CounterPathCallBack.
dwCallBackArg
Valore definito dal chiamante passato alla funzione di callback.
CallBackStatus
Nella voce della funzione di callback, questo membro contiene lo stato del buffer del percorso. Al termine, la funzione di callback imposta il valore di stato risultante dall'elaborazione.
Se il buffer è troppo piccolo per caricare la selezione corrente, il dialogo imposta questo valore su PDH_MORE_DATA. Se questo valore è ERROR_SUCCESS, il membro szReturnPathBuffer contiene un percorso di contatore o un elenco di percorsi contatori validi.
Se la funzione di callback rialloca un nuovo buffer, deve impostare questo membro su PDH_RETRY in modo che il dialogo tenti di caricare il buffer con i percorsi selezionati e chiamare di nuovo la funzione di callback.
Se si è verificato un altro errore, la funzione di callback deve restituire il valore di stato di errore PDH appropriato.
dwDefaultDetailLevel
Livello di dettaglio predefinito da visualizzare nell'elenco Livello dettaglio se bHideDetailBox è FALSE. Se bHideDetailBox è TRUE, la finestra di dialogo usa questo valore per filtrare i contatori e gli oggetti delle prestazioni visualizzati. È possibile specificare uno dei valori seguenti:
szDialogBoxCaption
Puntatore a una stringa con terminazione Null che specifica il didascalia facoltativo da visualizzare nella barra didascalia della finestra di dialogo. Se questo membro è NULL, il didascalia sarà Sfoglia contatori delle prestazioni.
Commenti
Ogni volta che si fa clic sul pulsante Aggiungi , il buffer szReturnPathBuffer contiene il contatore selezionato e viene chiamata la funzione di callback pCallBack . La funzione di callback deve chiamare la funzione PdhAddCounter per ogni contatore nel buffer.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Intestazione | pdh.h |