Struttura WTSLISTENERCONFIGW (wtsapi32.h)
Contiene informazioni su un listener di Servizi Desktop remoto. Questa struttura viene usata dalla funzione WTSCreateListener
Sintassi
typedef struct _WTSLISTENERCONFIGW {
ULONG version;
ULONG fEnableListener;
ULONG MaxConnectionCount;
ULONG fPromptForPassword;
ULONG fInheritColorDepth;
ULONG ColorDepth;
ULONG fInheritBrokenTimeoutSettings;
ULONG BrokenTimeoutSettings;
ULONG fDisablePrinterRedirection;
ULONG fDisableDriveRedirection;
ULONG fDisableComPortRedirection;
ULONG fDisableLPTPortRedirection;
ULONG fDisableClipboardRedirection;
ULONG fDisableAudioRedirection;
ULONG fDisablePNPRedirection;
ULONG fDisableDefaultMainClientPrinter;
ULONG LanAdapter;
ULONG PortNumber;
ULONG fInheritShadowSettings;
ULONG ShadowSettings;
ULONG TimeoutSettingsConnection;
ULONG TimeoutSettingsDisconnection;
ULONG TimeoutSettingsIdle;
ULONG SecurityLayer;
ULONG MinEncryptionLevel;
ULONG UserAuthentication;
WCHAR Comment[WTS_COMMENT_LENGTH + 1];
WCHAR LogonUserName[USERNAME_LENGTH + 1];
WCHAR LogonDomain[DOMAIN_LENGTH + 1];
WCHAR WorkDirectory[MAX_PATH + 1];
WCHAR InitialProgram[MAX_PATH + 1];
} WTSLISTENERCONFIGW, *PWTSLISTENERCONFIGW;
Membri
version
Questo membro è riservato.
fEnableListener
Specifica se il listener è abilitato. Questo membro può essere uno dei valori seguenti.
0
Il listener è disabilitato.
1
Il listener è abilitato.
MaxConnectionCount
Numero massimo di connessioni attive accettate dal listener.
fPromptForPassword
Specifica se il listener richiede sempre all'utente una password. Questo membro può essere uno dei valori seguenti.
0
Richiedere all'utente una password solo se specificata dal server.
1
Richiedi sempre all'utente una password.
fInheritColorDepth
Specifica se il listener deve utilizzare la profondità del colore specificata dall'utente. Questo membro può essere uno dei valori seguenti.
0
Usare la profondità del colore specificata dal server.
1
Usare la profondità del colore specificata dall'utente.
ColorDepth
Impostazione della profondità del colore per il listener. Questa impostazione si applica solo quando il membro fInheritColorDepth è zero. Può trattarsi di uno dei valori seguenti.
1
8 bit
2
15 bit
3
16 bit
4
24 bit
5
32 bit
fInheritBrokenTimeoutSettings
Specifica se il listener deve usare il BrokenTimeoutSettings valore specificato dall'utente. Questo membro può essere uno dei valori seguenti.
0
Usare il BrokenTimeoutSettings valore specificato dal server.
1
Usare il BrokenTimeoutSettings valore specificato dall'utente.
BrokenTimeoutSettings
L'azione eseguita dal listener quando scade una connessione o un timer inattiva o quando una connessione viene persa a causa di un errore di connessione. Questa impostazione si applica solo quando il membro
0
Quando una connessione o un timer inattiva scade o quando una connessione viene persa a causa di un errore di connessione, l'utente viene disconnesso ma la sessione rimane nel server.
1
Quando una connessione o un timer inattiva scade o quando una connessione viene persa a causa di un errore di connessione, la sessione viene terminata.
fDisablePrinterRedirection
Specifica se il reindirizzamento della stampante è disabilitato. Questo membro può essere uno dei valori seguenti.
0
L'utente può abilitare il reindirizzamento della stampante.
1
Il reindirizzamento della stampante è disabilitato.
fDisableDriveRedirection
Specifica se il reindirizzamento delle unità è disabilitato. Questo membro può essere uno dei valori seguenti.
0
L'utente può abilitare il reindirizzamento delle unità.
1
Il reindirizzamento delle unità è disabilitato.
fDisableComPortRedirection
Specifica se il reindirizzamento delle porte COM è disabilitato. Questo membro può essere uno dei valori seguenti.
0
L'utente può abilitare il reindirizzamento delle porte COM.
1
Il reindirizzamento delle porte COM è disabilitato.
fDisableLPTPortRedirection
Specifica se il reindirizzamento delle porte LPT è disabilitato. Questo membro può essere uno dei valori seguenti.
0
L'utente può abilitare il reindirizzamento delle porte LPT.
1
Il reindirizzamento delle porte LPT è disabilitato.
fDisableClipboardRedirection
Specifica se il reindirizzamento degli Appunti è disabilitato. Questo membro può essere uno dei valori seguenti.
0
L'utente può abilitare il reindirizzamento degli Appunti.
1
Il reindirizzamento degli Appunti è disabilitato.
fDisableAudioRedirection
Specifica se il reindirizzamento audio è disabilitato. Questo membro può essere uno dei valori seguenti.
0
L'utente può abilitare il reindirizzamento audio.
1
Il reindirizzamento audio è disabilitato.
fDisablePNPRedirection
Specifica se il reindirizzamento plug and play è disabilitato. Questo membro può essere uno dei valori seguenti.
0
L'utente può abilitare il reindirizzamento plug and play.
1
Il reindirizzamento plug and play è disabilitato.
fDisableDefaultMainClientPrinter
Specifica se la stampante client è la stampante predefinita. Questo membro può essere uno dei valori seguenti.
0
La stampante client non è la stampante predefinita.
1
La stampante client è la stampante predefinita.
LanAdapter
Scheda di rete utilizzata dal listener.
PortNumber
Numero di porta del listener.
fInheritShadowSettings
Specifica se il listener deve usare il valore
0
Usare l'impostazione specificata dal server.
1
Usare l'impostazione specificata dall'utente.
ShadowSettings
Impostazione del controllo remoto per il listener. Il controllo remoto consente a un utente di monitorare in remoto le operazioni sullo schermo di un altro utente. Questa impostazione si applica solo quando il membro
0
Il controllo remoto è disabilitato.
1
L'utente del controllo remoto ha il controllo completo della sessione dell'utente, con l'autorizzazione dell'utente.
2
L'utente del controllo remoto ha il controllo completo della sessione dell'utente; l'autorizzazione dell'utente non è necessaria.
3
L'utente del controllo remoto può visualizzare la sessione in remoto, con l'autorizzazione dell'utente; l'utente remoto non può controllare attivamente la sessione.
4
L'utente del controllo remoto può visualizzare la sessione in remoto ma non controllare attivamente la sessione; l'autorizzazione dell'utente non è necessaria.
TimeoutSettingsConnection
Durata massima della connessione, espressa in millisecondi. Ogni volta che l'utente accede, il timer viene reimpostato. Un valore pari a zero indica che il timer di connessione è disabilitato.
TimeoutSettingsDisconnection
Durata massima, in millisecondi, che un server mantiene una sessione disconnessa prima che l'accesso venga terminato. Un valore zero indica che il timer di disconnessione è disabilitato.
TimeoutSettingsIdle
Tempo di inattività massimo, espresso in millisecondi. Un valore pari a zero indica che il timer inattiva è disabilitato.
SecurityLayer
Livello di sicurezza del listener. Questo membro può essere uno dei valori seguenti.
0
Remote Desktop Protocol (RDP) viene usato dal server e dal client per l'autenticazione prima che venga stabilita una connessione.
1
Il server e il client negoziano il metodo per l'autenticazione prima che venga stabilita una connessione.
2
Il protocollo Transport Layer Security (TLS) viene usato dal server e dal client per l'autenticazione prima che venga stabilita una connessione.
MinEncryptionLevel
Livello di crittografia del listener. Questo membro può essere uno dei valori seguenti.
1
I dati inviati dal client al server vengono crittografati usando la crittografia a 56 bit. I dati inviati dal server al client non vengono crittografati.
2
Tutti i dati inviati dal client al server e dal server al client vengono crittografati usando il livello massimo di complessità della chiave supportato dal client.
3
Tutti i dati inviati dal client al server e dal server al client vengono crittografati usando la crittografia a 128 bit. I client che non supportano questo livello di crittografia non possono connettersi.
4
Tutti i dati inviati dal client al server e dal server al client vengono crittografati e decrittografati usando gli algoritmi di crittografia FIPS (Federal Information Processing Standards) e i moduli di crittografia Microsoft.
UserAuthentication
Specifica se è necessaria l'autenticazione utente a livello di rete prima che venga stabilita la connessione. Questo membro può essere uno dei valori seguenti.
0
L'autenticazione utente a livello di rete non è necessaria.
1
È necessaria l'autenticazione utente a livello di rete.
Comment[WTS_COMMENT_LENGTH + 1]
Stringa con terminazione Null contenente una descrizione del listener.
LogonUserName[USERNAME_LENGTH + 1]
Stringa con terminazione Null contenente il nome utente usato negli scenari di accesso automatico.
LogonDomain[DOMAIN_LENGTH + 1]
Stringa con terminazione Null contenente il nome di dominio usato negli scenari di accesso automatico.
WorkDirectory[MAX_PATH + 1]
Stringa con terminazione Null che contiene il percorso della directory di lavoro del programma iniziale.
InitialProgram[MAX_PATH + 1]
Stringa con terminazione Null contenente il nome del programma da avviare immediatamente dopo l'accesso dell'utente al server.
Osservazioni
Nota
L'intestazione wtsapi32.h definisce WTSLISTENERCONFIG 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 |
| intestazione |
wtsapi32.h |