WTSEnumerateProcessesA-Funktion (wtsapi32.h)

  • Artikel

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)

Weitere Informationen

WTS_PROCESS_INFO