Freigeben über


PdhCloseQuery-Funktion (pdh.h)

Schließt alle Leistungsindikatoren, die in der angegebenen Abfrage enthalten sind, schließt alle Handles im Zusammenhang mit der Abfrage und gibt den gesamten der Abfrage zugeordneten Arbeitsspeicher frei.

Syntax

PDH_FUNCTION PdhCloseQuery(
  [in] PDH_HQUERY hQuery
);

Parameter

[in] hQuery

Behandeln Sie die zu schließende Abfrage. Dieses Handle wird von der PdhOpenQuery-Funktion zurückgegeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück. Andernfalls gibt die Funktion einen Systemfehlercode oder einen PDH-Fehlercode zurück.

Im Folgenden ist ein möglicher Wert aufgeführt.

Rückgabecode Beschreibung
PDH_INVALID_HANDLE
Das Abfragehandle ist ungültig.

Hinweise

Verwenden Sie nach dem Aufrufen dieser Funktion nicht die Dieser Abfrage zugeordneten Indikatorenhandles.

Im Folgenden wird die Syntax veranschaulicht, wenn diese Funktion über Visual Basic aufgerufen wird.

PdhCloseQuery(
  ByVal QueryHandle as Long  
)
as Long

Beispiele

Ein Beispiel finden Sie unter Durchsuchen von Leistungsindikatoren oder Lesen von Leistungsdaten aus einer Protokolldatei.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile pdh.h
Bibliothek Pdh.lib
DLL Pdh.dll

Weitere Informationen

PdhOpenQuery