WTSEnumerateProcessesExA-Funktion (wtsapi32.h)

Ruft Informationen zu den aktiven Prozessen auf dem angegebenen Remotedesktopsitzungshostserver (RD-Sitzungshost) oder Remotedesktopvirtualisierungshostserver (RD Virtualization Host) 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 für einen RD-Sitzungshostserver. Geben Sie ein Von der WTSOpenServer-Funktion geöffnetes Handle an, oder geben Sie WTS_CURRENT_SERVER_HANDLE an, um den Server anzugeben, auf dem Ihre Anwendung ausgeführt wird.

[in, out] pLevel

Ein Zeiger auf eine DWORD-Variable , die bei der Eingabe den Typ der zurückzugebenden Informationen angibt. Geben Sie null an, um ein Array von WTS_PROCESS_INFO Strukturen zurückzugeben. Um ein Array von WTS_PROCESS_INFO_EX-Strukturen zurückzugeben, geben Sie eins an.

Wenn Sie keinen gültigen Wert für diesen Parameter angeben, legt WTSEnumerateProcessesEx in der Ausgabe diesen Parameter auf einen fest und gibt einen Fehler zurück. Andernfalls ändert WTSEnumerateProcessesEx in der Ausgabe den Wert dieses Parameters nicht.

[in] SessionId

Die Sitzung, für die Prozesse aufgelistet werden sollen. Um Prozesse für alle Sitzungen auf dem Server aufzulisten, geben Sie WTS_ANY_SESSION an.

[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 die Verwendung des Arrays abgeschlossen haben, 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 von empfängt
Strukturen, die im Puffer zurückgegeben werden, auf den der ppProcessInfo-Parameter verweist.

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 die GetLastError-Funktion auf.

Hinweise

Der Aufrufer muss Mitglied der Gruppe Administratoren sein, um Prozesse aufzulisten, die unter einer anderen Benutzersitzung ausgeführt werden.

Hinweis

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 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 7
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
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)

Weitere Informationen

WTSOpenServer

WTS_PROCESS_INFO

WTS_PROCESS_INFO_EX