Condividi tramite


Metodo IWTSProtocolManager::CreateListener (wtsprotocol.h)

[IWTSProtocolManager::CreateListener non è più disponibile per l'uso a partire da Windows Server 2012. Usare invece IWRdsProtocolManager::CreateListener.]

Richiede la creazione di un oggetto IWTSProtocolListener in ascolto delle richieste di connessione client in ingresso. Il provider di protocollo deve aggiungere un riferimento all'oggetto IWTSProtocolListener prima di restituire . Il servizio Servizi Desktop remoto rilascia il riferimento quando il servizio si arresta o l'oggetto listener viene eliminato.

Sintassi

HRESULT CreateListener(
  [in]  WCHAR                *wszListenerName,
  [out] IWTSProtocolListener **pProtocolListener
);

Parametri

[in] wszListenerName

Puntatore a una stringa contenente il GUID del Registro di sistema che specifica il listener da creare.

[out] pProtocolListener

Indirizzo di un puntatore all'oggetto IWTSProtocolListener .

Valore restituito

Quando si implementa questo metodo, restituire S_OK se la funzione ha esito positivo. Se ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Il metodo CreateListener è la prima chiamata eseguita dal servizio Servizi Desktop remoto nel provider di protocolli. Il servizio cerca nel Registro di sistema sotto la chiave seguente per trovare il GUID del listener da creare:

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Control
            Terminal Server
               WinStations
                  ListenerName
                     LoadableProtocol_Object

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2008 R2
Piattaforma di destinazione Windows
Intestazione wtsprotocol.h

Vedi anche

IWTSProtocolManager