WTSOpenServerA-Funktion (wtsapi32.h)
Öffnet ein Handle für den angegebenen Remotedesktopsitzungshostserver (RD-Sitzungshost).
Syntax
HANDLE WTSOpenServerA(
[in] LPSTR pServerName
);
Parameter
[in] pServerName
Zeiger auf eine mit Null beendete Zeichenfolge, die den NetBIOS-Namen des RD-Sitzungshostservers angibt.
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 ihn in einem anderen Funktionsaufruf verwenden.
Bemerkungen
Wenn Sie den von WTSOpenServerzurückgegebenen Handle verwendet haben, lassen Sie es los, indem Sie die funktion WTSCloseServer aufrufen.
Sie müssen kein Handle für Vorgänge öffnen, die auf dem RD-Sitzungshostserver ausgeführt werden, auf dem Ihre Anwendung ausgeführt wird. Verwenden Sie stattdessen die Konstante WTS_CURRENT_SERVER_HANDLE.
Anmerkung
Der wtsapi32.h-Header definiert WTSOpenServer 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 |