次の方法で共有

IWTSProtocolConnection::QueryProperty メソッド (wtsprotocol.h)

  • [アーティクル]

[IWTSProtocolConnection::QueryProperty は、Windows Server 2012の時点で使用できなくなります。 代わりに、 IWRdsProtocolConnection::QueryProperty.] を使用します。

プロトコルから指定したプロパティを取得します。 このメソッドは、他の Windows モジュールがプロトコルからデータを要求したり、プロトコルにデータを送信したりするために使用できます。

構文

HRESULT QueryProperty(
  [in]            GUID                QueryType,
  [in]            ULONG               ulNumEntriesIn,
  [in]            ULONG               ulNumEntriesOut,
  [in, optional]  PWTS_PROPERTY_VALUE pPropertyEntriesIn,
  [out, optional] PWTS_PROPERTY_VALUE pPropertyEntriesOut
);

パラメーター

[in] QueryType

プロパティを指定する GUID 。 これには、次のいずれかの値を指定できます。

WTS_QUERY_ALLOWED_INITIAL_APP (C77D1B30-5BE1-4c6b-A0E1-BD6D2E5C9FCC)

リモート デスクトップ サービス サービスによって送信され、初期アプリケーションの実行を許可する必要があるかどうかを判断します。

入力時に、リモート デスクトップ サービス サービスは pPropertyEntriesIn パラメーターで次の 3 つのWTS_PROPERTY_VALUE構造体を渡します。

入力構造体 1:

  • pPropertyEntriesIn[0]。Type = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = アプリケーション名
  • pPropertyEntriesIn[0].u.strVal.size = 名前文字列の長さ
入力構造 2:
  • pPropertyEntriesIn[1]。Type = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[1].u.strVal.pstrVal = アプリケーション パラメーター
  • pPropertyEntriesIn[1].u.strVal.size = パラメーター文字列の長さ
入力構造 3:
  • pPropertyEntriesIn[2]。Type = WTS_VALUE_TYPE_ULONG
  • pPropertyEntriesIn[2].u.ulVal = 予約済み
出力時に、pPropertyEntriesOut パラメーターに次の 3 つのWTS_PROPERTY_VALUE構造体を渡します。 リモート デスクトップ サービス サービスによって渡されたアプリケーションを使用する場合は、入力構造体 1 と 2 を出力構造体 1 と 2 にコピーします。

出力構造 1:

  • pPropertyEntriesOut[0]。Type = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[0].u.strVal.pstrVal = ディレクトリを含むコマンド ライン
  • pPropertyEntriesOut[0].u.strVal.size = コマンド ラインの長さ
出力構造 2:
  • pPropertyEntriesOut[1]。Type = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[1].u.strVal.pstrVal = アプリケーション パラメーター
  • pPropertyEntriesOut[1].u.strVal.size = パラメーター文字列の長さ
出力構造 3:
  • pPropertyEntriesOut[2].Type = WTS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[2].u.ulVal = アプリケーションを実行する場合は 0 以外の値、停止する場合は 0

WTS_QUERY_LOGON_SCREEN_SIZE (8b8e0fe7-0804-4a0e-b279-8660b1df0049)

ログオン画面のサイズを決定するために WinLogon によって使用されます。

pPropertyEntriesIn パラメーターは NULL になります。

pPropertyEntriesOut パラメーターを次のように設定します。

  • pPropertyEntriesOut[0]。Type = WTS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 画面サイズ
既定の画面サイズを使用しない場合、プロトコルは E_NOTIMPLを返す必要があります。

WTS_QUERY_AUDIOENUM_DLL (9bf4fa97-c883-4c2a-80ab-5a39c9af00db)

リモート オーディオ列挙子 DLL の名前を照会するためにリモート デスクトップ サービス サービスによって使用されます。

pPropertyEntriesIn パラメーターは NULL になります。

pPropertyEntriesOut パラメーターを次のように設定します。

  • pPropertyEntriesOut[0]。Type = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[0].u.strVal.pstrVal = DLL 名
LocalAlloc 関数を使用して、pstrVal のメモリを割り当てる必要があります。

WTS_QUERY_MF_FORMAT_SUPPORT (41869ad0-6332-4dc8-95d5-db749e2f1d94)

特定のメディア形式に使用するシンク オブジェクトを決定するために、リモート デスクトップ Media Foundation プラグインによって使用されます。

入力時に、RCM は pPropertyEntriesIn パラメーターに次のWTS_PROPERTY_VALUE構造体を渡します。

出力時に、pPropertyEntriesOut パラメーターに次のWTS_PROPERTY_VALUE構造体を渡します。

PROPERTY_DYNAMIC_TIME_ZONE_INFORMATION (cdfd28e-d0b9-4c1f-a5eb-6d1f6c6535b9)

接続から動的タイム ゾーン情報を取得するために使用されます。

pPropertyEntriesIn パラメーターは NULL になります。

出力時に、pPropertyEntriesOut パラメーターに次のWRDS_PROPERTY_VALUE構造体を渡します。

[in] ulNumEntriesIn

pPropertyEntriesIn 引数で渡されるWTS_PROPERTY_VALUE構造体の数を含む整数。

[in] ulNumEntriesOut

pPropertyEntriesOut 引数で渡されるWTS_PROPERTY_VALUE構造体の数を含む整数。

[in, optional] pPropertyEntriesIn

要求されたプロパティ情報 の 検索に使用できる 1 つ以上のWTS_PROPERTY_VALUE構造体。

[out, optional] pPropertyEntriesOut

要求されたプロパティ情報を含む 1 つ以上の WTS_PROPERTY_VALUE 構造体。

戻り値

なし

必要条件

要件 値
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2008 R2
対象プラットフォーム Windows
ヘッダー wtsprotocol.h (Wtsdefs.h を含む)

こちらもご覧ください

IWRdsProtocolConnection

IWRdsProtocolConnection::QueryProperty

IWTSProtocolConnection

TSMF_SUPPORT_DATA_IN

TSMF_SUPPORT_DATA_OUT

WRDS_DYNAMIC_TIME_ZONE_INFORMATION

WTS_PROPERTY_VALUE