次の方法で共有

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

  • [アーティクル]

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

構文

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

パラメーター

[in] QueryType

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

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

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

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

入力構造体 1:

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

出力構造 1:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_BINARY
  • pPropertyEntriesOut[0].u.bVal.pbVal = TSMF_SUPPORT_DATA_IN 構造体
  • pPropertyEntriesOut[0].u.bVal.size = TSMF_SUPPORT_DATA_IN構造体のサイズ
出力時に、pPropertyEntriesOut パラメーターに次のWRDS_PROPERTY_VALUE構造体を渡します。

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

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

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

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

カーソルの点滅を無効にするかどうかを判断するために使用されます。

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

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = カーソルの点滅を無効にする場合は 1、それ以外の場合は 0

PROPERTY_TYPE_GET_FAST_RECONNECT (6212d757-0043-4862-99c3-9f3059ac2a3b)

リモート デスクトップ サービス サービスによって使用される再接続のモードを決定するために使用されます。

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

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 高速再接続を無効にするには 0、基本高速再接続の場合は 1、拡張高速再接続の場合は 2

PROPERTY_TYPE_GET_FAST_RECONNECT_USER_SID (197c427a-0135-4b6d-9c5e-e6579a0ab625)

拡張高速再接続中にリモート デスクトップ サービス サービスによって使用され、再接続先のセッションがフィルター処理されるユーザー SID を取得します。

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

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = セッション フィルターとして使用するユーザー SID
  • pPropertyEntriesIn[0].u.strVal.size = null 終端文字を含むユーザー SID の長さ
LocalAlloc 関数を使用して、pstrVal のメモリを割り当てる必要があります。

PROPERTY_TYPE_ENABLE_UNIVERSAL_APPS_FOR_CUSTOM_SHELL (ed2c3fda-338d-4d3f-81a3-e767310d908e)

リモート デスクトップ サービス サービスによって使用され、セッションの作成時にカスタム シェルの前に ShellAppRuntime.exe が起動されるかどうかを決定します。 ShellAppRuntime.exe は、カスタム シェルのユニバーサル アプリ サポートを実装します。 これは既定では有効になっていません (0 を渡すことと同じです)。 これは、Server 2019 以降またはマルチセッション ビルド 18950 以降Windows 10 Windows バージョンで使用できます。

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

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = カスタム シェルのユニバーサル アプリ サポートを有効にしない場合は 0、1 カスタム シェルのユニバーサル アプリサポートを有効にする

CONNECTION_PROPERTY_IDLE_TIME_WARNING (693f7ff5-0c4e-4d17-b8e0-1f70325e5d58)

アイドル タイマーの有効期限が切れたときにログオフ警告プロンプトが表示されるかどうかを判断するために使用します。

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

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 警告プロンプトを無効にするには 0、有効にするには 1

[in] ulNumEntriesIn

pPropertyEntriesIn 配列内のエントリの数。

[in] ulNumEntriesOut

pPropertyEntriesOut 配列内のエントリの数。

[in, optional] pPropertyEntriesIn

要求されたプロパティ情報の検索に使用できる WRDS_PROPERTY_VALUE 構造体へのポインターの配列。

[out, optional] pPropertyEntriesOut

要求されたプロパティ値を受け取る WRDS_PROPERTY_VALUE 構造体へのポインターの配列。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

要件

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

こちらもご覧ください

IWRdsProtocolConnection