Funzione WTSCreateListenerA (wtsapi32.h)

Articolo
03/04/2024

Crea un nuovo listener servizi Desktop remoto o configura un listener esistente.

Sintassi

BOOL WTSCreateListenerA(
  [in] HANDLE              hServer,
  [in] PVOID               pReserved,
  [in] DWORD               Reserved,
  [in] LPSTR               pListenerName,
  [in] PWTSLISTENERCONFIGA pBuffer,
  [in] DWORD               flag
);

Parametri

[in] hServer

Handle per un server host sessione Desktop remoto. Impostare sempre questo parametro su WTS_CURRENT_SERVER_HANDLE.

[in] pReserved

Questo parametro è riservato. Impostare sempre questo parametro su NULL.

[in] Reserved

Questo parametro è riservato. Impostare sempre questo parametro su zero.

[in] pListenerName

Puntatore a una stringa con terminazione null contenente il nome del listener da creare o configurare.

[in] pBuffer

Puntatore a una struttura WTSLISTENERCONFIG che contiene informazioni di configurazione per il listener.

[in] flag

Scopo della chiamata. Questo parametro può avere uno dei valori seguenti.

WTS_LISTENER_CREATE (1 (0x1))

Creare un nuovo listener.

WTS_LISTENER_UPDATE (16 (0x10))

Aggiornare le impostazioni di un listener esistente.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .

Commenti

Questa funzione crea o configura un listener che usa Remote Desktop Protocol (RDP). Impostare sempre il membro della versione della struttura WTSLISTENERCONFIG a cui punta il parametro pBuffer su uno.

Questa funzione non crea o configura il descrittore di sicurezza del listener. Quando si chiama questa funzione per creare un nuovo listener, la funzione assegna il descrittore di sicurezza predefinito al nuovo listener. Per modificare il descrittore di sicurezza, chiamare la funzione WTSSetListenerSecurity . Per altre informazioni sui descrittori di sicurezza, vedere SECURITY_DESCRIPTOR.

Questa funzione non convalida le impostazioni per il nuovo listener. Assicurarsi che le impostazioni siano valide prima di chiamare questa funzione.

Nota

L'intestazione wtsapi32.h definisce WTSCreateListener come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7
Server minimo supportato	Windows Server 2008 R2
Piattaforma di destinazione	Windows
Intestazione	wtsapi32.h
Libreria	Wtsapi32.lib
DLL	Wtsapi32.dll