Struttura WTSUSERCONFIGA (wtsapi32.h)
Contiene informazioni di configurazione per un utente in un controller di dominio o in un server Host sessione Desktop remoto . Questa struttura viene usata dalle funzioni WTSQueryUserConfig e WTSSetUserConfig .
Sintassi
typedef struct _WTSUSERCONFIGA {
DWORD Source;
DWORD InheritInitialProgram;
DWORD AllowLogonTerminalServer;
DWORD TimeoutSettingsConnections;
DWORD TimeoutSettingsDisconnections;
DWORD TimeoutSettingsIdle;
DWORD DeviceClientDrives;
DWORD DeviceClientPrinters;
DWORD ClientDefaultPrinter;
DWORD BrokenTimeoutSettings;
DWORD ReconnectSettings;
DWORD ShadowingSettings;
DWORD TerminalServerRemoteHomeDir;
CHAR InitialProgram[MAX_PATH + 1];
CHAR WorkDirectory[MAX_PATH + 1];
CHAR TerminalServerProfilePath[MAX_PATH + 1];
CHAR TerminalServerHomeDir[MAX_PATH + 1];
CHAR TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1];
} WTSUSERCONFIGA, *PWTSUSERCONFIGA;
Members
Source
Valore del tipo di enumerazione WTS_CONFIG_SOURCE che specifica l'origine delle informazioni di configurazione restituite dalla funzione WTSQueryUserConfig .
InheritInitialProgram
Valore che indica se il client può specificare il programma iniziale. Questo membro può essere uno dei valori seguenti.
0
Il client non può specificare il programma iniziale. Al contrario, il programma specificato dal membro InitialProgram viene avviato automaticamente quando l'utente accede al server. Il server disconnette l'utente quando l'utente esce da tale programma.
1
Il client può specificare il programma iniziale.
AllowLogonTerminalServer
Valore che indica se l'account utente è autorizzato ad accedere a un server host sessione Desktop remoto. Questo membro può essere uno dei valori seguenti.
0
L'utente non può accedere.
1
L'utente può accedere.
TimeoutSettingsConnections
Durata massima della connessione, in millisecondi. Un minuto prima della scadenza della connessione, il server notifica all'utente la disconnessione in sospeso. Quando si verifica il timeout della connessione, il server esegue l'azione specificata dal membro BrokenTimeoutSettings . Ogni volta che l'utente accede, il timer viene reimpostato. Il valore zero indica che il timer di connessione è disabilitato.
TimeoutSettingsDisconnections
Durata massima, in millisecondi, che il server mantiene una sessione disconnessa prima che l'accesso venga terminato. Il valore zero indica che il timer di disconnessione è disabilitato.
TimeoutSettingsIdle
Quantità di tempo, in millisecondi, che una connessione può rimanere inattiva. Se non è presente alcuna attività della tastiera o del mouse per questo periodo di tempo, il server esegue l'azione specificata dal membro BrokenTimeoutSettings . Il valore zero indica che il timer di inattività è disabilitato.
DeviceClientDrives
Questo membro è riservato.
DeviceClientPrinters
Valore che indica se il server si connette automaticamente alle stampanti client mappate in precedenza quando l'utente accede al server. Questo membro può essere uno dei valori seguenti.
0
Il server non si connette automaticamente alle stampanti client mappate in precedenza.
1
Il server si connette automaticamente alle stampanti client mappate in precedenza.
ClientDefaultPrinter
Valore che indica 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.
BrokenTimeoutSettings
L'azione eseguita dal server quando scade la connessione o i timer inattive o quando una connessione viene persa a causa di un errore di connessione. Questo membro può essere uno dei valori seguenti.
0
La sessione è disconnessa, ma rimane nel server.
1
La sessione viene terminata.
ReconnectSettings
Valore che indica come è possibile riconnettere una sessione disconnessa per questo utente. Questo membro può essere uno dei valori seguenti.
0
L'utente può accedere a qualsiasi computer client per riconnettersi a una sessione disconnessa.
1
L'utente deve accedere al computer client usato originariamente per stabilire la sessione disconnessa. Se l'utente accede a un computer client diverso, l'utente ottiene una nuova sessione.
ShadowingSettings
Impostazione del controllo remoto. Il controllo remoto consente a un utente di monitorare in remoto le operazioni sullo schermo di un altro utente. 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.
TerminalServerRemoteHomeDir
Valore che indica se il membro TerminalServerHomeDir contiene un percorso di una directory locale o di una condivisione di rete. Non è possibile impostare questo membro usando la funzione WTSSetUserConfig . Questo membro può essere uno dei valori seguenti.
0
Il membro TerminalServerHomeDir contiene un percorso di una directory locale.
1
Il membro TerminalServerHomeDir contiene un percorso di una condivisione di rete e il membro TerminalServerHomeDirDrive contiene una lettera di unità a cui è mappato questo percorso.
InitialProgram[MAX_PATH + 1]
Stringa con terminazione Null contenente il nome del programma da avviare immediatamente dopo l'accesso dell'utente al server.
WorkDirectory[MAX_PATH + 1]
Stringa con terminazione Null che contiene il percorso della directory di lavoro per il programma iniziale.
TerminalServerProfilePath[MAX_PATH + 1]
Stringa con terminazione Null che contiene il percorso del profilo assegnato all'utente quando l'utente si connette al server. La directory specificata dal percorso deve essere creata manualmente e deve esistere prima dell'accesso.
TerminalServerHomeDir[MAX_PATH + 1]
Stringa con terminazione Null che contiene il percorso della home cartella delle sessioni di Servizi Desktop remoto dell'utente. La cartella può essere una cartella locale o una condivisione di rete.
TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1]
Stringa con terminazione Null che contiene il nome dell'unità (una lettera di unità seguita da due punti) a cui viene mappato il percorso specificato nel membro TerminalServerHomeDir . Questo membro è valido solo quando il membro TerminalServerRemoteHomeDir è impostato su uno.
Commenti
Nota
L'intestazione wtsapi32.h definisce WTSUSERCONFIG 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Client minimo supportato | Windows 7 |
| Server minimo supportato | Windows Server 2008 R2 |
| Intestazione | wtsapi32.h |