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 |