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.

Commenti

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 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

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione wtsapi32.h
Libreria Wtsapi32.lib
DLL Wtsapi32.dll

Vedi anche

WTSCloseServer