Funzione WTSCreateListenerW (wtsapi32.h)

Articolo
11/20/2024

Crea un nuovo listener di Servizi Desktop remoto o configura un listener esistente.

Sintassi

BOOL WTSCreateListenerW(
  [in] HANDLE              hServer,
  [in] PVOID               pReserved,
  [in] DWORD               Reserved,
  [in] LPWSTR              pListenerName,
  [in] PWTSLISTENERCONFIGW 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 di WTSLISTENERCONFIG che contiene informazioni di configurazione per il listener.

[in] flag

Scopo della chiamata. Questo parametro può essere 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 estese sull'errore, chiamare la funzione GetLastError .

Osservazioni

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

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 7
server minimo supportato	Windows Server 2008 R2
piattaforma di destinazione	Finestre
intestazione	wtsapi32.h
libreria	Wtsapi32.lib
dll	Wtsapi32.dll