WTSOpenServerExW-Funktion (wtsapi32.h)

  • Artikel

Öffnet ein Handle für den angegebenen Remotedesktopsitzungshostserver (RD-Sitzungshost) oder Remotedesktopvirtualisierungshostserver (RD Virtualization Host).

Syntax

HANDLE WTSOpenServerExW(
  [in] LPWSTR pServerName
);

Parameter

[in] pServerName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den NetBIOS-Namen des Servers enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den angegebenen Server.

Wenn die Funktion fehlschlägt, wird ein ungültiges Handle zurückgegeben. Sie können die Gültigkeit des Handles testen, indem Sie es in einem anderen Funktionsaufruf verwenden.

Hinweise

Wenn der vom pServerName-Parameter angegebene Server ein RD-Sitzungshostserver ist, ist das Verhalten dieser Funktion mit dem der WTSOpenServer-Funktion identisch.

Um mit Sitzungen zu arbeiten, die auf virtuellen Computern auf dem RD-Virtualisierungshostserver ausgeführt werden, auf dem die aufrufende Anwendung ausgeführt wird, geben Sie WTS_CURRENT_SERVER_NAME für den Parameter pServerName an.

Wenn Sie das von dieser Funktion zurückgegebene Handle verwendet haben, geben Sie es durch Aufrufen der WTSCloseServer-Funktion frei.

Hinweis

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

Weitere Informationen

WTSCloseServer

WTSOpenServer