WTSCreateListenerA-Funktion (wtsapi32.h)
Erstellt einen neuen Listener für Remotedesktopdienste oder konfiguriert einen vorhandenen Listener.
Syntax
BOOL WTSCreateListenerA(
[in] HANDLE hServer,
[in] PVOID pReserved,
[in] DWORD Reserved,
[in] LPSTR pListenerName,
[in] PWTSLISTENERCONFIGA pBuffer,
[in] DWORD flag
);
Parameter
[in] hServer
Ein Handle zu einem RD-Sitzungshostserver. Legen Sie diesen Parameter immer auf WTS_CURRENT_SERVER_HANDLEfest.
[in] pReserved
Dieser Parameter ist reserviert. Legen Sie diesen Parameter immer auf NULL-fest.
[in] Reserved
Dieser Parameter ist reserviert. Legen Sie diesen Parameter immer auf Null fest.
[in] pListenerName
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen des Listeners enthält, der erstellt oder konfiguriert werden soll.
[in] pBuffer
Ein Zeiger auf eine WTSLISTENERCONFIG- Struktur, die Konfigurationsinformationen für den Listener enthält.
[in] flag
Der Zweck des Anrufs. Dieser Parameter kann einer der folgenden Werte sein:
WTS_LISTENER_CREATE (1 (0x1))
Erstellen Sie einen neuen Listener.
WTS_LISTENER_UPDATE (16 (0x10))
Aktualisieren Sie die Einstellungen eines vorhandenen Listeners.
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 zum Abrufen erweiterter Fehlerinformationen die GetLastError--Funktion auf.
Bemerkungen
Diese Funktion erstellt oder konfiguriert einen Listener, der Remotedesktopprotokoll- (RDP) verwendet. Legen Sie immer die Version Member der WTSLISTENERCONFIG Struktur fest, auf die durch den pBuffer-Parameter verwiesen wird.
Diese Funktion erstellt oder konfiguriert den Sicherheitsdeskriptor des Listeners nicht. Wenn Sie diese Funktion aufrufen, um einen neuen Listener zu erstellen, weist die Funktion dem neuen Listener den Standardsicherheitsdeskriptor zu. Rufen Sie zum Ändern der Sicherheitsbeschreibung die WTSSetListenerSecurity-Funktion auf. Weitere Informationen zu Sicherheitsdeskriptoren finden Sie unter SECURITY_DESCRIPTOR.
Diese Funktion überprüft die Einstellungen für den neuen Listener nicht. Stellen Sie sicher, dass die Einstellungen gültig sind, bevor Sie diese Funktion aufrufen.
Anmerkung
Der wtsapi32.h-Header definiert WTSCreateListener 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 7 |
| mindestens unterstützte Server- | Windows Server 2008 R2 |
| Zielplattform- | Fenster |
| Header- | wtsapi32.h |
| Library | Wtsapi32.lib |
| DLL- | Wtsapi32.dll |