Funzione WTSVirtualChannelOpen (wtsapi32.h)
Apre un handle alla fine del server di un canale virtuale specificato.
questa funzione è obsoleta. Usare invece la funzione WTSVirtualChannelOpenEx .
Sintassi
HANDLE WTSVirtualChannelOpen(
[in] HANDLE hServer,
[in] DWORD SessionId,
[in] LPSTR pVirtualName
);
Parametri
[in] hServer
Questo parametro deve essere WTS_CURRENT_SERVER_HANDLE.
[in] SessionId
Identificatore di sessione di Servizi Desktop remoto. Per indicare la sessione corrente, specificare WTS_CURRENT_SESSION. È possibile usare la funzione WTSEnumerateSessions per recuperare gli identificatori di tutte le sessioni in un server host sessione Desktop remoto specificato.
Per aprire un canale virtuale nella sessione di un altro utente, è necessario disporre dell'autorizzazione dal canale virtuale. Per altre informazioni, vedere Autorizzazioni di Servizi Desktop remoto. Per modificare le autorizzazioni per una sessione, usare lo strumento di amministrazione configurazione di Servizi Desktop remoto.
[in] pVirtualName
Puntatore a una stringa con terminazione Null contenente il nome del canale virtuale. Si noti che si tratta di una stringa ANSI anche quando viene definito UNICODE. Il nome del canale virtuale è costituito da uno a CHANNEL_NAME_LEN caratteri, senza includere il valore Null di terminazione.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle per il canale virtuale specificato.
Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Al termine dell'uso dell'handle, rilasciarlo chiamando la funzione WTSVirtualChannelClose .
Per un esempio che illustra come ottenere l'accesso a un handle di file del canale virtuale che può essere usato per l'I/O asincrona, vedere WTSVirtualChannelQuery.
Se si tenta di usare questa funzione per aprire più volte lo stesso canale virtuale, può causare un ritardo di 10 secondi e interrompere il canale stabilito.
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 |
| Set di API | ext-ms-win-session-wtsapi32-l1-1-0 (introdotto in Windows 8) |