Funzione WTSOpenServerExA (wtsapi32.h)
Apre un handle al server Host sessione Desktop remoto (Host sessione Desktop remoto) specificato o al server Remote Desktop Virtualization Host (Rd Virtualization Host).
Sintassi
HANDLE WTSOpenServerExA(
[in] LPSTR pServerName
);
Parametri
[in] pServerName
Puntatore a una stringa con terminazione Null contenente il nome NetBIOS del server.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle per il server specificato.
Se la funzione non riesce, restituisce un handle non valido. È possibile testare la validità dell'handle usandolo in un'altra chiamata di funzione.
Osservazioni
Se il server specificato dal parametro pServerName è un server Host sessione Desktop remoto, il comportamento di questa funzione è identico a quello della funzione WTSOpenServer.
Per usare le sessioni in esecuzione nelle macchine virtuali nel server Host di virtualizzazione Desktop remoto in cui è in esecuzione l'applicazione chiamante, specificare
Al termine dell'uso dell'handle restituito da questa funzione, rilasciarlo chiamando la funzione WTSCloseServer.
Nota
L'intestazione wtsapi32.h definisce WTSOpenServerEx 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 |