Struttura WTSLISTENERCONFIGA (wtsapi32.h)
Contiene informazioni su un listener di Servizi Desktop remoto. Questa struttura viene usata dalla funzione WTSCreateListener .
Sintassi
typedef struct _WTSLISTENERCONFIGA {
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;
CHAR Comment[WTS_COMMENT_LENGTH + 1];
CHAR LogonUserName[USERNAME_LENGTH + 1];
CHAR LogonDomain[DOMAIN_LENGTH + 1];
CHAR WorkDirectory[MAX_PATH + 1];
CHAR InitialProgram[MAX_PATH + 1];
} WTSLISTENERCONFIGA, *PWTSLISTENERCONFIGA;
Members
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
Richiedere sempre all'utente una password.
fInheritColorDepth
Specifica se il listener deve usare la profondità del colore specificata dall'utente. Questo membro può essere uno dei valori seguenti.
0
Utilizzare la profondità del colore specificata dal server.
1
Utilizzare 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. Questo può essere 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 valore BrokenTimeoutSettings specificato dall'utente. Questo membro può essere uno dei valori seguenti.
0
Usare il valore BrokenTimeoutSettings specificato dal server.
1
Usare il valore BrokenTimeoutSettings specificato dall'utente.
BrokenTimeoutSettings
L'azione eseguita dal listener quando scade una connessione o un timer inattiva oppure quando si perde una connessione a causa di un errore di connessione. Questa impostazione si applica solo quando il membro fInheritBrokenTimeoutSettings è zero. Questo membro può essere uno dei valori seguenti.
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 dell'unità è disabilitato. Questo membro può essere uno dei valori seguenti.
0
L'utente può abilitare il reindirizzamento unità.
1
Il reindirizzamento dell'unità è disabilitato.
fDisableComPortRedirection
Specifica se il reindirizzamento della porta COM è disabilitato. Questo membro può essere uno dei valori seguenti.
0
L'utente può abilitare il reindirizzamento della porta COM.
1
Il reindirizzamento della porta COM è disabilitato.
fDisableLPTPortRedirection
Specifica se il reindirizzamento della porta LPT è disabilitato. Questo membro può essere uno dei valori seguenti.
0
L'utente può abilitare il reindirizzamento della porta LPT.
1
Il reindirizzamento della porta 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 Plug and Play reindirizzamento è disabilitato. Questo membro può essere uno dei valori seguenti.
0
L'utente può abilitare Plug and Play reindirizzamento.
1
Plug and Play reindirizzamento è 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 usata dal listener.
PortNumber
Numero di porta del listener.
fInheritShadowSettings
Specifica se il listener deve usare il valore ShadowSettings specificato dall'utente. Questo membro può essere uno dei valori seguenti.
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 fInheritShadowSettings è zero. Questo membro può essere uno dei valori seguenti.
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, 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
La durata massima, in millisecondi, che un server mantiene una sessione disconnessa prima che l'accesso venga terminato. Un valore pari a zero indica che il timer di disconnessione è disabilitato.
TimeoutSettingsIdle
Tempo di inattività massimo, 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 forza 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 l'autenticazione utente a livello di rete è necessaria 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 automatici.
LogonDomain[DOMAIN_LENGTH + 1]
Stringa con terminazione null contenente il nome di dominio usato negli scenari di accesso automatici.
WorkDirectory[MAX_PATH + 1]
Stringa con terminazione null contenente 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.
Commenti
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 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 |
| Intestazione | wtsapi32.h |