WTSEnumerateProcessesA-Funktion (wtsapi32.h)
Ruft Informationen zu den aktiven Prozessen auf einem angegebenen Remotedesktopsitzungshostserver (RD-Sitzungshost) ab.
Syntax
BOOL WTSEnumerateProcessesA(
[in] HANDLE hServer,
[in] DWORD Reserved,
[in] DWORD Version,
[out] PWTS_PROCESS_INFOA *ppProcessInfo,
[out] DWORD *pCount
);
Parameter
[in] hServer
Verarbeiten mit einem RD-Sitzungshostserver. Geben Sie ein Von der WTSOpenServer-Funktion geöffnetes Handle an, 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. Um den zurückgegebenen Puffer freizugeben, rufen Sie die Funktion WTSFreeMemory auf .
[out] pCount
Zeiger auf eine Variable, die die Anzahl der imppProcessInfo-Puffer zurückgegebenen WTS_PROCESS_INFO Strukturen empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Der Aufrufer muss Mitglied der Gruppe Administratoren sein, um Prozesse aufzulisten, die unter dem Kontext eines anderen Benutzers ausgeführt werden.
Hinweis
Der wtsapi32.h-Header definiert WTSEnumerateProcesses als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista |
Unterstützte Mindestversion (Server) | Windows Server 2008 |
Zielplattform | Windows |
Kopfzeile | wtsapi32.h |
Bibliothek | Wtsapi32.lib |
DLL | Wtsapi32.dll |
APIs | ext-ms-win-session-wtsapi32-l1-1-0 (eingeführt in Windows 8) |