WTSEnumerateProcessesA-Funktion (wtsapi32.h)

Artikel
11/20/2024

Ruft Informationen zu den aktiven Prozessen auf einem angegebenen Remotedesktopsitzungshostserver (RD Session Host) ab.

Syntax

BOOL WTSEnumerateProcessesA(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_PROCESS_INFOA *ppProcessInfo,
  [out] DWORD              *pCount
);

Parameter

[in] hServer

Behandeln sie einen RD-Sitzungshostserver. Geben Sie ein Handle an, das von der WTSOpenServer--Funktion geöffnet wird, oder geben Sie WTS_CURRENT_SERVER_HANDLE an, um den RD-Sitzungshostserver anzugeben, auf dem Ihre Anwendung ausgeführt wird.

[in] Reserved

Reserviert; muss null sein.

[in] Version

Gibt die Version der Enumerationsanforderung an. Muss 1 sein.

[out] ppProcessInfo

Zeiger auf eine Variable, die einen Zeiger auf ein Array von WTS_PROCESS_INFO Strukturen empfängt. Jede Struktur im Array enthält Informationen zu einem aktiven Prozess auf dem angegebenen RD-Sitzungshostserver. Rufen Sie zum Freigeben des zurückgegebenen Puffers die WTSFreeMemory-Funktion auf.

[out] pCount

Zeiger auf eine Variable, die die Anzahl der im ppProcessInfo- Puffer zurückgegebenen WTS_PROCESS_INFO Strukturen empfängt.

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Der Aufrufer muss Mitglied der Gruppe "Administratoren" sein, um Prozesse auflisten zu können, die unter dem Kontext eines anderen Benutzers ausgeführt werden.

Anmerkung

Der wtsapi32.h-Header definiert WTSEnumerateProcesses 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 Vista
mindestens unterstützte Server-	Windows Server 2008
Zielplattform-	Fenster
Header-	wtsapi32.h
Library	Wtsapi32.lib
DLL-	Wtsapi32.dll
API-Satz	ext-ms-win-session-wtsapi32-l1-1-0 (eingeführt in Windows 8)

Siehe auch

WTS_PROCESS_INFO

Freigeben über