IWRdsProtocolManager::CreateListener メソッド (wtsprotocol.h)

  • [アーティクル]

受信クライアント接続要求をリッスンする IWRdsProtocolListener オブジェクトの作成を要求します。 プロトコル プロバイダーは、戻る前に IWRdsProtocolListener オブジェクトへの参照を追加する必要があります。 リモート デスクトップ サービス サービスは、サービスが停止するか、リスナー オブジェクトが削除されたときに参照を解放します。

構文

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

パラメーター

[in] wszListenerName

作成するリスナーを指定するレジストリ GUID を含む文字列へのポインター。

[out] pProtocolListener

IWRdsProtocolListener オブジェクトへのポインターのアドレス。

戻り値

このメソッドを実装する場合は、関数 が成功した場合S_OK を返します。 失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

解説

CreateListener メソッドは、リモート デスクトップ サービス サービスがプロトコル プロバイダーに対して行う最初の呼び出しです。 サービスは、次のキーの下にあるレジストリを検索して、作成するリスナーの GUID を見つけます。

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Control
            Terminal Server
               WinStations
                  ListenerName
                     LoadableProtocol_Object

要件

   
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2012
対象プラットフォーム Windows
ヘッダー wtsprotocol.h

関連項目

IWRdsProtocolManager