WTSEnumerateProcessesExA-Funktion (wtsapi32.h)
Ruft Informationen zu den aktiven Prozessen auf dem angegebenen Rd Desktop Session Host (RD Session Host)-Server oder RemoteDesktop Virtualization Host (RD Virtualization Host)-Server ab.
Syntax
BOOL WTSEnumerateProcessesExA(
[in] HANDLE hServer,
[in, out] DWORD *pLevel,
[in] DWORD SessionId,
[out] LPSTR *ppProcessInfo,
[out] DWORD *pCount
);
Parameter
[in] hServer
Ein Handle zu einem 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 Server anzugeben, auf dem Die Anwendung ausgeführt wird.
[in, out] pLevel
Ein Zeiger auf eine DWORD- Variable, die bei Eingabe den Typ der zurückzugebenden Informationen angibt. Geben Sie null an, um ein Array von WTS_PROCESS_INFO Strukturen zurückzugeben. Geben Sie ein Array von WTS_PROCESS_INFO_EX Strukturen zurück.
Wenn Sie keinen gültigen Wert für diesen Parameter angeben, legt WTSEnumerateProcessesEx diesen Parameter auf einen fest und gibt einen Fehler zurück. Andernfalls ändert
[in] SessionId
Die Sitzung, für die Prozesse aufgezählt werden sollen. Wenn Sie Prozesse für alle Sitzungen auf dem Server auflisten möchten, geben Sie WTS_ANY_SESSIONan.
[out] ppProcessInfo
Ein Zeiger auf eine Variable, die einen Zeiger auf ein Array von WTS_PROCESS_INFO oder WTS_PROCESS_INFO_EX Strukturen empfängt. Der Typ der Struktur wird durch den Wert bestimmt, der an den pLevel Parameter übergeben wird. Jede Struktur im Array enthält Informationen zu einem aktiven Prozess. Wenn Sie mit der Verwendung des Arrays fertig sind, geben Sie es frei, indem Sie die funktion WTSFreeMemoryEx aufrufen. Sie sollten auch den Zeiger auf NULL-festlegen.
[out] pCount
Ein Zeiger auf eine Variable, die die Anzahl der
Strukturen, die im Puffer zurückgegeben werden, auf den vom ppProcessInfo Parameter verwiesen wird.
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 zum Abrufen erweiterter Fehlerinformationen die GetLastError--Funktion auf.
Bemerkungen
Der Aufrufer muss Mitglied der Gruppe "Administratoren" sein, um Prozesse auflisten zu können, die unter einer anderen Benutzersitzung ausgeführt werden.
Anmerkung
Der wtsapi32.h-Header definiert WTSEnumerateProcessesEx 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 7 |
| mindestens unterstützte Server- | Windows Server 2008 R2 |
| 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) |