Funzione WTSOpenServerExA (wtsapi32.h)
Apre un handle al server Host sessione Desktop remoto (Host sessione Desktop remoto) o al server Host di virtualizzazione Desktop remoto (Host di virtualizzazione Desktop remoto).
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 ha esito negativo, restituisce un handle non valido. È possibile testare la validità dell'handle usandolo in un'altra chiamata di funzione.
Commenti
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 WTS_CURRENT_SERVER_NAME per il parametro pServerName .
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 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 |
| Piattaforma di destinazione | Windows |
| Intestazione | wtsapi32.h |
| Libreria | Wtsapi32.lib |
| DLL | Wtsapi32.dll |