WTSEnumerateServersW-Funktion (wtsapi32.h)

Artikel
11/20/2024

Gibt eine Liste aller Remotedesktopsitzungshostserver (RD Session Host) innerhalb der angegebenen Domäne zurück.

Syntax

BOOL WTSEnumerateServersW(
  [in] LPWSTR            pDomainName,
  [in] DWORD             Reserved,
  [in] DWORD             Version,
       PWTS_SERVER_INFOW *ppServerInfo,
       DWORD             *pCount
);

Parameter

[in] pDomainName

Zeigen Sie auf den Namen der Domäne, die abgefragt werden soll. Wenn der Wert dieses Parameters NULL-ist, ist die angegebene Domäne die aktuelle Domäne.

[in] Reserved

Reserviert. Der Wert dieses Parameters muss 0 sein.

[in] Version

Version der Enumerationsanforderung. Der Wert des Parameters muss 1 sein.

ppServerInfo

Verweist auf ein Array von WTS_SERVER_INFO Strukturen, das die zurückgegebenen Ergebnisse der Enumeration enthält. Nach der Verwendung sollte der von diesem Puffer verwendete Speicher durch Aufrufen WTSFreeMemoryfreigegeben werden.

pCount

Zeiger auf eine Variable, die die Anzahl der im ppServerInfo Puffer zurückgegebenen WTS_SERVER_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

Diese Funktion funktioniert nicht, wenn NetBT deaktiviert ist.

Anmerkung

Der wtsapi32.h-Header definiert WTSEnumerateServers 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

Siehe auch

WTS_SERVER_INFO

Freigeben über