Funzione WTSOpenServerA (wtsapi32.h)
Apre un handle per il server Host sessione Desktop remoto (Host sessione Desktop remoto) specificato.
Sintassi
HANDLE WTSOpenServerA(
[in] LPSTR pServerName
);
Parametri
[in] pServerName
Puntatore a una stringa con terminazione Null che specifica il nome NetBIOS del server Host sessione Desktop remoto.
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.
Osservazioni
Al termine dell'uso dell'handle restituito da WTSOpenServer, rilasciarlo chiamando la funzione WTSCloseServer.
Non è necessario aprire un handle per le operazioni eseguite nel server Host sessione Desktop remoto in cui è in esecuzione l'applicazione. Usare invece la costante WTS_CURRENT_SERVER_HANDLE.
Nota
L'intestazione wtsapi32.h definisce WTSOpenServer 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 Vista |
| server minimo supportato | Windows Server 2008 |
| piattaforma di destinazione | Finestre |
| intestazione |
wtsapi32.h |
| libreria |
Wtsapi32.lib |
| dll | Wtsapi32.dll |