PDH_BROWSE_DLG_CONFIG_HA Struktur (pdh.h)
Die PDH_BROWSE_DLG_CONFIG_H Struktur wird von der PdhBrowseCountersH--Funktion verwendet, um das Dialogfeld Leistungsindikatoren durchsuchen zu konfigurieren.
Syntax
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;
Angehörige
bIncludeInstanceIndex
Wenn dieses Kennzeichen TRUEist, enthält das Dialogfeld eine Indexnummer für doppelte Instanzennamen. Wenn beispielsweise zwei cmd-Instanzen vorhanden sind, enthält die Instanzliste cmd und cmd#1. Wenn dieses Kennzeichen FALSE-ist, enthalten doppelte Instanzennamen keine Indexnummer.
bSingleCounterPerAdd
Wenn dieses Kennzeichen TRUEist, gibt das Dialogfeld nur einen Zähler zurück. Wenn dieses Kennzeichen FALSE-ist, kann das Dialogfeld mehrere Auswahlmöglichkeiten zurückgeben, und Die Auswahl von Wildcards ist zulässig. Ausgewählte Leistungsindikatoren werden als MULTI_SZ Zeichenfolge zurückgegeben.
bSingleCounterPerDialog
Wenn dieses Kennzeichen TRUEist, verwendet das Dialogfeld eine Schaltfläche "OK" und "Abbrechen". Das Dialogfeld wird zurückgegeben, wenn der Benutzer auf eine der Schaltflächen klickt. Wenn dieses Kennzeichen FALSE-ist, verwendet das Dialogfeld eine 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 Kennzeichen TRUEist, kann der Benutzer im Dialogfeld Zähler nur auf dem lokalen Computer auswählen (der Pfad enthält keinen Computernamen). Wenn dieses Kennzeichen FALSE-ist, kann der Benutzer einen Computer angeben, von dem Zähler ausgewählt werden sollen. Der Computername stellt dem Zählerpfad das Präfix voran, es sei denn, der Benutzer wählt Verwenden von lokalen Computerzählern.
bWildCardInstances
Wenn dieses Kennzeichen TRUE ist und der Benutzer Alle Instanzenauswählt, enthält der Zählerpfad das Platzhalterzeichen für das Instanzfeld.
Wenn dieses Flag FALSE-ist und der Benutzer Alle Instanzenauswählt, werden alle Instanzen, die derzeit für dieses Objekt gefunden werden, in einer MULTI_SZ Zeichenfolge zurückgegeben.
bHideDetailBox
Wenn dieses Kennzeichen TRUEist, wird Detailebene aus dem Dialogfeld entfernt, sodass der Benutzer die Detailebene der im Dialogfeld angezeigten Leistungsindikatoren nicht ändern kann. Die Detailebene wird auf den Wert des dwDefaultDetailLevel Members festgelegt.
Wenn dieses Kennzeichen FALSE-ist, wird Detailebene im Dialogfeld angezeigt, sodass der Benutzer die Detailebene der angezeigten Zähler ändern kann.
Beachten Sie, dass die angezeigten Leistungsindikatoren diejenigen sind, deren Detailebene kleiner oder gleich der auswahl der aktuellen Detailebene ist. Wenn Sie eine Detailebene des Assistenten auswählen, werden alle Zähler und Objekte angezeigt.
bInitializePath
Wenn dieses Flag TRUEist, hebt das Dialogfeld den Zähler und das Objekt hervor, das in szReturnPathBuffer angegeben ist, wenn das Dialogfeld zum ersten Mal angezeigt wird, anstatt den vom Computer angegebenen Standardzähler und Objekt zu verwenden.
Wenn dieses Kennzeichen FALSE-ist, wird der anfängliche Zähler und das Objekt mithilfe des vom Computer zurückgegebenen Standardindikators und Objektinformationen ausgewählt.
bDisableMachineSelection
Wenn dieses Kennzeichen TRUE-ist, kann der Benutzer keinen Computer aus Zähler vom Computer auswählen.
Wenn dieses Kennzeichen FALSE-ist, kann der Benutzer einen Computer aus Auswahlzähler von Computerauswä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 Kennzeichen TRUEist, enthält die Leistungsindikatorenliste auch kostspielige Daten, d. h. Daten, die eine relativ große Menge Prozessorzeit oder Arbeitsspeicheraufwand für die Erfassung erfordern.
Wenn diese Kennzeichnung FALSE-ist, enthält die Liste keine kostspieligen Indikatoren. Dies ist der Standardwert.
bShowObjectBrowser
Wenn dieses Kennzeichen TRUE-ist, werden im Dialogfeld nur Leistungsobjekte aufgelistet. Wenn der Benutzer ein Objekt auswählt, gibt das Dialogfeld einen Zählerpfad zurück, der das Objekt und die Wildcardzeichen für den Instanznamen und den Zähler enthält, wenn es sich bei dem Objekt um ein Objekt mit mehreren Instanzen handelt. Wenn beispielsweise das "Process"-Objekt ausgewählt ist, gibt das Dialogfeld die Zeichenfolge "\Process(*)*" zurück. Wenn es sich bei dem Objekt um ein einzelnes Instanzobjekt handelt, enthält der Pfad nur ein Wildcardzeichen 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 das Dialogfeld zu besitzen. Wenn NULL-, ist der Besitzer der Desktop.
hDataSource
Handle to a data source returned by the PdhBindInputDataSource function.
szReturnPathBuffer
Zeigen Sie auf eine MULTI_SZ, die die ausgewählten Zählerpfade enthält.
Wenn bInitializePathTRUEist, können Sie mit diesem Element einen Zählerpfad angeben, dessen Komponenten zum Hervorheben von Einträgen in Computer-, Objekt-, Leistungs- und Instanzlisten verwendet werden, wenn das Dialogfeld zum ersten Mal angezeigt wird.
cchReturnPathLength
Größe des szReturnPathBuffer Puffers in TCHARs. Wenn die Rückruffunktion einen neuen Puffer neu zuteilt, muss dieser Wert ebenfalls aktualisiert werden.
pCallBack
Zeigen Sie auf die Rückruffunktion, die die Auswahl des Benutzers verarbeitet. Weitere Informationen finden Sie unter CounterPathCallBack-.
dwCallBackArg
Caller-defined value that is passed to the callback function.
CallBackStatus
Bei der Eingabe in die Rückruffunktion enthält dieses Element den Status des Pfadpuffers. Beim Beenden legt die Rückruffunktion den Statuswert 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 Member einen gültigen Zählerpfad oder eine Zählerpfadliste.
Wenn die Rückruffunktion einen neuen Puffer neu zugeordnet, sollte dieses Element auf PDH_RETRY festgelegt werden, sodass 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-Fehlerstatuswert zurückgeben.
dwDefaultDetailLevel
Standarddetailebene, die in der Detailebene Liste angezeigt werden soll, wenn bHideDetailBox-FALSE-ist. Wenn bHideDetailBox-TRUE-ist, verwendet das Dialogfeld diesen Wert, um die angezeigten Leistungsindikatoren und -objekte zu filtern. Sie können einen der folgenden Werte angeben:
szDialogBoxCaption
Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die die optionale Beschriftung angibt, die in der Beschriftungsleiste des Dialogfelds angezeigt werden soll. Wenn dieser Member NULL-ist, wird die Beschriftung Leistungsindikatoren durchsuchen.
Bemerkungen
Jedes Mal, wenn auf die Schaltfläche Hinzufügen geklickt wird, enthält der szReturnPathBuffer Puffer 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.
Anmerkung
Der pdh.h-Header definiert PDH_BROWSE_DLG_CONFIG_H als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Header- | pdh.h |