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 |
|---|---|
|
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 |