Condividi tramite


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)

Vedi anche

WTSEnumerateSessions

WTSOpenServer

WTSVirtualChannelClose