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

Vedi anche

WTSCloseServer

WTSOpenServer