struttura PDH_BROWSE_DLG_CONFIG_HA (pdh.h)
La struttura PDH_BROWSE_DLG_CONFIG_H viene utilizzata dalla funzione PdhBrowseCountersH per configurare la finestra di dialogo Sfoglia contatori delle prestazioni.
Sintassi
typedef struct _BrowseDlgConfig_HA {
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;
PDH_HLOG hDataSource;
LPSTR szReturnPathBuffer;
DWORD cchReturnPathLength;
CounterPathCallBack pCallBack;
DWORD_PTR dwCallBackArg;
PDH_STATUS CallBackStatus;
DWORD dwDefaultDetailLevel;
LPSTR szDialogBoxCaption;
} PDH_BROWSE_DLG_CONFIG_HA, *PPDH_BROWSE_DLG_CONFIG_HA;
Membri
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 usa 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 usa un pulsante Aggiungi e Chiudi. La finestra di dialogo si chiude 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 i 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 prefissi il percorso del contatore a meno che l'utente non selezioni Utilizzare 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 è FALSEe 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, questo rimuove livello dettaglio 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 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. Se si seleziona 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 specificato in szReturnPathBuffer quando viene visualizzata per la prima volta la finestra di dialogo, anziché utilizzare il contatore e l'oggetto predefiniti specificati dal computer.
Se questo flag è FALSE, questo seleziona il contatore iniziale e l'oggetto usando il contatore predefinito e le informazioni sull'oggetto restituite dal computer.
bDisableMachineSelection
Se questo flag è TRUE, l'utente non può selezionare un computer da Selezionare i contatori dal computer.
Se questo flag è FALSE, l'utente può selezionare un computer da Selezionare i contatori dal computer. Questo è il valore predefinito.
L'elenco contiene solo il computer locale, a meno che non si chiami prima il pdhConnectMachine
bIncludeCostlyObjects
Se questo flag è TRUE, l'elenco dei contatori conterrà anche dati costosi, ovvero dati che richiedono una quantità relativamente elevata di tempo del processore o sovraccarico di memoria da raccogliere.
Se questo flag è FALSE, l'elenco non conterrà contatori costosi. Questo è il valore predefinito.
bShowObjectBrowser
Se questo flag è TRUE, la finestra di dialogo elenca 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 dell'istanza e il contatore se l'oggetto è un oggetto a istanza multipla. Ad esempio, se l'oggetto "Process" è selezionato, la finestra di dialogo restituisce la stringa "\Process(*)*". Se l'oggetto è un singolo oggetto 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 possedere il dialogo. Se null, il proprietario è il desktop.
hDataSource
Handle in un'origine dati restituita dalla funzione PdhBindInputDataSource.
szReturnPathBuffer
Puntatore a un MULTI_SZ che contiene 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 la finestra di dialogo per la prima volta.
cchReturnPathLength
Dimensioni del buffer di szReturnPathBuffer
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. All'uscita, la funzione di callback imposta il valore di stato risultante dall'elaborazione.
Se il buffer è troppo piccolo per caricare la selezione corrente, la finestra di 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 del contatore valido.
Se la funzione di callback rialloca un nuovo buffer, deve impostare questo membro su PDH_RETRY in modo che la finestra di dialogo tenti di caricare il buffer con i percorsi selezionati e chiami nuovamente 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 dettagli
szDialogBoxCaption
Puntatore a un nullstringa con terminazione che specifica la didascalia facoltativa da visualizzare nella barra della didascalia della finestra di dialogo. Se questo membro è NULL, la didascalia verrà Sfoglia contatori delle prestazioni.
Osservazioni
Ogni volta che si fa clic sul pulsante Aggiungi
Nota
L'intestazione pdh.h definisce PDH_BROWSE_DLG_CONFIG_H come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows XP [solo app desktop] |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| intestazione |
pdh.h |