Freigeben über

Überprüfen von Statuscodes für Zählerdaten

  • Artikel

Der Rückgabewert von PDH-Funktionen gibt den Erfolg oder Fehler des Funktionsaufrufs an, der sich von der status der Zählerdaten unterscheidet. Überprüfen Sie immer den CStatus-Member eines Zählerwerts, der in den PDH-Strukturen zurückgegeben wird, um sicherzustellen, dass die zurückgegebenen Daten gültig sind, bevor Sie ihn verwenden. Wenn der Wert des CStatus-Members keinen Erfolg anzeigt, verwenden Sie die Daten nicht. Im Folgenden sind die möglichen status Werte für Indikatoren aufgeführt:

Wert Bedeutung
PDH_CSTATUS_NO_MACHINE PDH konnte keine Verbindung mit dem im Indikatorpfad angegebenen Computer herstellen. Wenn diese status zurückgegeben wird, wenn der Zähler hinzugefügt wird, wird der Zähler nicht vollständig initialisiert. Jedes Mal, wenn die Abfrage aktualisiert wird, wiederholt PDH die Verbindung. Wenn die Verbindung hergestellt wird, wird die normale Datensammlung fortgesetzt.
PDH_CSTATUS_NO_OBJECT Der angegebene Computer wurde gefunden, aber das angegebene Leistungsobjekt wurde auf dem Computer gefunden. Wenn diese status zurückgegeben wird, wenn der Zähler hinzugefügt wird, wird der angegebene Indikator nicht in der Abfrage enthalten. Wenn dieser status von einem aktiven Zähler zurückgegeben wird, sind die Daten für diesen Leistungsindikator ungültig. Jedes Mal, wenn die Daten angefordert werden, versucht PDH, diese Zählerdaten abzurufen.
PDH_CSTATUS_NO_INSTANCE Die angegebene instance wurde im -Objekt nicht gefunden. Wenn diese status zurückgegeben wird, während der Leistungsindikator der Abfrage hinzugefügt wird, wird der Indikator erfolgreich zur Abfrage hinzugefügt, aber es sind keine Daten verfügbar, bis die bestimmte instance angezeigt wird und eine erfolgreiche status zurückgegeben wird.
PDH_CSTATUS_NO_COUNTER Der angegebene Indikator wurde im angegebenen Objekt nicht gefunden. Wenn diese status zurückgegeben wird, wenn der Zähler hinzugefügt wird, wird der Indikator der Abfrage nicht hinzugefügt. Wenn diese status nach der Datensammlung zurückgegeben wird, sind die Daten für diesen Leistungsindikator ungültig. Jedes Mal, wenn die Daten angefordert werden, versucht PDH, diese Zählerdaten abzurufen.
PDH_CSTATUS_INVALID_DATA Der Indikator wurde erfolgreich gefunden, aber die zurückgegebenen Daten sind ungültig. Dieser Fehler kann auftreten, wenn der Zählerwert kleiner als der vorherige Wert ist. (Da Zählerwerte immer inkrementieren, rollt der Zählerwert auf 0, wenn er seinen Höchstwert erreicht.) Eine weitere mögliche Ursache ist ein Systemtimer, der nicht richtig ist.
PDH_CSTATUS_VALID_DATA Die Daten für den Leistungsindikator wurden erfolgreich zurückgegeben, sind aber seit dem letzten Lesen des Indikators unverändert.
PDH_CSTATUS_NEW_DATA Die Daten für den Leistungsindikator wurden erfolgreich zurückgegeben und unterscheiden sich von dem Zeitpunkt, zu dem der Indikator zuletzt gelesen wurde. PDH_CSTATUS_NEW_DATA kann für einen Ratenzähler zurückgegeben werden, auch wenn die resultierende Rate mit dem letzten Beispiel identisch ist. Dies liegt daran, dass der Rohdatenwert, der bei der Ermittlung dieses status Werts verwendet wird, geändert wurde, nicht die berechnete Rate.
PDH_MORE_DATA Der bereitgestellte Puffer war nicht groß genug, um alle Zählerdaten zu speichern. Ordnen Sie einen größeren Puffer zu, und führen Sie die Funktion erneut aus.
PDH_CSTATUS_ITEM_NOT_VALIDATED Der Indikator wurde der Abfrage hinzugefügt, aber weder überprüft noch wurde darauf zugegriffen. Es sind keine zusätzlichen status Informationen zu diesem Leistungsindikator verfügbar.
PDH_CSTATUS_NO_COUNTERNAME In der Abfrage wurde kein Zählername angegeben.
PDH_CSTATUS_NO_COUNTER Der angegebene Zählername konnte nicht gefunden werden.
PDH_CSTATUS_NO_OBJECT Das angegebene Leistungsobjekt konnte nicht gefunden werden.
PDH_CALC_NEGATIVE_DENOMINATOR Ein Zähler hat einen negativen Nennerwert.
PDH_CALC_NEGATIVE_TIMEBASE Ein Zähler weist einen negativen Timebasewert auf.
PDH_CALC_NEGATIVE_VALUE Ein Zähler hat einen negativen Wert.
PDH_CSTATUS_NO_COUNTERNAME Es wurde kein Zählerpfad angegeben.
PDH_CSTATUS_BAD_COUNTERNAME Das Format des Indikatorpfads ist falsch.