GetProcessHandleCount-Funktion (processthreadsapi.h)

  • Artikel

Ruft die Anzahl geöffneter Handles ab, die zum angegebenen Prozess gehören.

Syntax

BOOL GetProcessHandleCount(
  [in]      HANDLE hProcess,
  [in, out] PDWORD pdwHandleCount
);

Parameter

[in] hProcess

Ein Handle für den Prozess, dessen Handleanzahl angefordert wird. Das Handle muss über das PROCESS_QUERY_INFORMATION- oder PROCESS_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

Windows Server 2003 und Windows XP: Das Handle muss über das zugriffsrecht PROCESS_QUERY_INFORMATION verfügen.

[in, out] pdwHandleCount

Ein Zeiger auf eine Variable, die die Anzahl der geöffneten Handles empfängt, die zum angegebenen Prozess gehören.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Funktion ruft Informationen zu den Executive-Objekten für den Prozess ab. Weitere Informationen finden Sie unter Kernelobjekte.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0501 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile processthreadsapi.h (enthalten Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Prozess- und Threadfunktionen

Prozesse