PDH_BROWSE_DLG_CONFIG_A-Struktur (pdh.h)
Die PDH_BROWSE_DLG_CONFIG-Struktur wird von der PdhBrowseCounters-Funktion verwendet, um das Dialogfeld Leistungsindikatoren durchsuchen zu konfigurieren.
Syntax
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;
Member
bIncludeInstanceIndex
Wenn dieses Flag TRUE ist, enthält das Dialogfeld eine Indexnummer für doppelte instance Namen. Wenn beispielsweise zwei cmd-Instanzen vorhanden sind, enthält die liste instance cmd und cmd#1. Wenn dieses Flag FALSE ist, enthalten doppelte instance Namen keine Indexnummer.
bSingleCounterPerAdd
Wenn dieses Flag TRUE ist, gibt das Dialogfeld nur einen Zähler zurück. Wenn dieses Flag FALSE ist, kann das Dialogfeld mehrere Auswahlmöglichkeiten zurückgeben, und Die Auswahl von Feldhaltern ist zulässig. Ausgewählte Leistungsindikatoren werden als MULTI_SZ Zeichenfolge zurückgegeben.
bSingleCounterPerDialog
Wenn dieses Flag TRUE ist, verwendet das Dialogfeld die Schaltflächen OK und Abbrechen. Das Dialogfeld wird zurückgegeben, wenn der Benutzer auf eine schaltfläche klickt. Wenn dieses Flag FALSE ist, verwendet das Dialogfeld die Schaltfläche Hinzufügen und Schließen. Das Dialogfeld wird geschlossen, wenn der Benutzer auf die Schaltfläche Schließen klickt. Auf die Schaltfläche Hinzufügen kann mehrmals geklickt werden. Die Schaltfläche Hinzufügen überschreibt die zuvor ausgewählten Elemente mit den aktuell ausgewählten Elementen.
bLocalCountersOnly
Wenn dieses Flag TRUE ist, kann der Benutzer im Dialogfeld Leistungsindikatoren nur auf dem lokalen Computer auswählen (der Pfad enthält keinen Computernamen). Wenn dieses Flag FALSE ist, kann der Benutzer einen Computer angeben, auf dem Indikatoren ausgewählt werden sollen. Der Computername präfixiert den Zählerpfad, es sei denn, der Benutzer wählt Lokale Computerindikatoren verwenden aus.
bWildCardInstances
Wenn dieses Flag TRUE ist und der Benutzer Alle Instanzen auswählt, enthält der Zählerpfad das Platzhalterzeichen für das Feld instance.
Wenn dieses Flag FALSE ist und der Benutzer Alle Instanzen auswählt, werden alle Instanzen, die derzeit für dieses Objekt gefunden wurden, in einer MULTI_SZ Zeichenfolge zurückgegeben.
bHideDetailBox
Wenn dieses Flag TRUE ist, wird die Detailebene aus dem Dialogfeld entfernt, sodass der Benutzer die Detailebene der im Dialogfeld angezeigten Indikatoren nicht ändern kann. Die Detailebene wird auf den Wert des dwDefaultDetailLevel-Elements festgelegt.
Wenn dieses Flag FALSE ist, wird die Detailebene im Dialogfeld angezeigt, sodass der Benutzer die Detailebene der angezeigten Indikatoren ändern kann.
Beachten Sie, dass die angezeigten Indikatoren diejenigen sind, deren Detailebene kleiner oder gleich der aktuellen Detailebenenauswahl ist. Wenn Sie eine Detailebene des Assistenten auswählen, werden alle Indikatoren und Objekte angezeigt.
bInitializePath
Wenn dieses Flag TRUE ist, hebt das Dialogfeld den Zähler und das Objekt hervor, die in szReturnPathBuffer angegeben sind, wenn das Dialogfeld zum ersten Mal angezeigt wird, anstatt den vom Computer angegebenen Standardindikator und das Vom Computer angegebene Objekt zu verwenden.
Wenn dieses Flag FALSE ist, werden der anfängliche Zähler und das Objekt mithilfe des Standardindikators und der vom Computer zurückgegebenen Objektinformationen ausgewählt.
bDisableMachineSelection
Wenn dieses Flag TRUE ist, kann der Benutzer keinen Computer unter Indikatoren vom Computer auswählen auswählen.
Wenn dieses Flag FALSE ist, kann der Benutzer einen Computer unter Indikatoren vom Computer auswählen auswählen. Dies ist der Standardwert. Die Liste enthält nur den lokalen Computer, es sei denn, Sie rufen die PdhConnectMachine auf, um zuerst eine Verbindung mit anderen Computern herzustellen.
bIncludeCostlyObjects
Wenn dieses Flag TRUE ist, enthält die Leistungsindikatorenliste auch kostspielige Daten, d. h. Daten, die eine relativ große Menge an Prozessorzeit oder Arbeitsspeicheraufwand erfordern.
Wenn dieses Flag FALSE ist, enthält die Liste keine kostspieligen Indikatoren. Dies ist der Standardwert.
bShowObjectBrowser
Wenn dieses Flag TRUE ist, werden im Dialogfeld nur Leistungsobjekte aufgelistet. Wenn der Benutzer ein Objekt auswählt, gibt das Dialogfeld einen Leistungsindikatorpfad zurück, der das Objekt und die Feldhalterzeichen für den instance Namen und den Zähler enthält, wenn es sich bei dem Objekt um ein Objekt mit mehreren instance handelt. Wenn beispielsweise das Objekt "Process" ausgewählt ist, gibt das Dialogfeld die Zeichenfolge "\Process(*)*" zurück. Wenn es sich bei dem Objekt um ein einzelnes instance-Objekt handelt, enthält der Pfad ein Feldhalterzeichen nur für den Zähler. Beispiel: "\System*". Anschließend können Sie den Pfad an PdhExpandWildCardPath übergeben, um eine Liste der tatsächlichen Pfade für das Objekt abzurufen.
bReserved
hWndOwner
Handle des Fensters, um den Dialog zu besitzen. Bei NULL ist der Besitzer der Desktop.
szDataSource
Zeiger auf eine NULL-Zeichenfolge, die den Namen der Protokolldatei angibt, aus der die Liste der Leistungsindikatoren abgerufen wird. Bei NULL wird die Liste der Leistungsindikatoren vom lokalen Computer (oder dem Remotecomputer, falls angegeben) abgerufen.
szReturnPathBuffer
Zeiger auf einen MULTI_SZ, der die ausgewählten Indikatorenpfade enthält.
Wenn bInitializePathTRUE ist, können Sie mit diesem Member einen Indikatorpfad angeben, dessen Komponenten verwendet werden, um Einträge in Computer-, Objekt-, Zähler- und instance Listen hervorzuheben, wenn das Dialogfeld zum ersten Mal angezeigt wird.
cchReturnPathLength
Größe des szReturnPathBuffer-Puffers in TCHARs. Wenn die Rückruffunktion einen neuen Puffer neu ordnet, muss sie auch diesen Wert aktualisieren.
pCallBack
Zeiger auf die Rückruffunktion, die die Auswahl des Benutzers verarbeitet. Weitere Informationen finden Sie unter CounterPathCallBack.
dwCallBackArg
Vom Aufrufer definierter Wert, der an die Rückruffunktion übergeben wird.
CallBackStatus
Beim Einstieg in die Rückruffunktion enthält dieses Element die status des Pfadpuffers. Beim Beenden legt die Rückruffunktion den status Wert fest, der sich aus der Verarbeitung ergibt.
Wenn der Puffer zu klein ist, um die aktuelle Auswahl zu laden, legt das Dialogfeld diesen Wert auf PDH_MORE_DATA fest. Wenn dieser Wert ERROR_SUCCESS ist, enthält das szReturnPathBuffer-Element einen gültigen Leistungsindikatorpfad oder eine liste von Indikatorenpfaden.
Wenn die Rückruffunktion einen neuen Puffer neu ordnet, sollte sie diesen Member auf PDH_RETRY festlegen, damit das Dialogfeld versucht, den Puffer mit den ausgewählten Pfaden zu laden und die Rückruffunktion erneut aufzurufen.
Wenn ein anderer Fehler aufgetreten ist, sollte die Rückruffunktion den entsprechenden PDH-Fehler status Wert zurückgeben.
dwDefaultDetailLevel
Standardmäßige Detailebene, die in der Liste Detailebene angezeigt werden soll, wenn bHideDetailBoxFALSE ist. Wenn bHideDetailBoxTRUE ist, wird im Dialogfeld dieser Wert verwendet, um die angezeigten Leistungsindikatoren und -objekte zu filtern. Sie können einen der folgenden Werte angeben:
szDialogBoxCaption
Zeiger auf eine NULL-Zeichenfolge, die die optionale Untertitel angibt, die in der Untertitel leiste des Dialogfelds angezeigt werden soll. Wenn dieses Element NULL ist, lautet der Untertitel Leistungsindikatoren durchsuchen.
Hinweise
Jedes Mal, wenn auf die Schaltfläche Hinzufügen geklickt wird, enthält der puffer szReturnPathBuffer den ausgewählten Zähler und die pCallBack-Rückruffunktion wird aufgerufen. Die Rückruffunktion sollte die PdhAddCounter-Funktion für jeden Zähler im Puffer aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | pdh.h |