IWTSProtocolConnection::QueryProperty-Methode (wtsprotocol.h)

  • Artikel

[IWTSProtocolConnection::QueryProperty ist ab Windows Server 2012 nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::QueryProperty.]

Ruft die angegebene Eigenschaft aus dem Protokoll ab. Diese Methode kann von anderen Windows-Modulen verwendet werden, um Daten vom Protokoll anzufordern oder an das Protokoll zu senden.

Syntax

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

Parameter

[in] QueryType

Eine GUID , die die -Eigenschaft angibt. Dies kann einer der folgenden Werte sein.

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

Wird vom Remotedesktopdienstedienst gesendet, um zu bestimmen, ob eine anfängliche Anwendung ausgeführt werden darf.

Bei der Eingabe übergibt der Remotedesktopdienste-Dienst drei WTS_PROPERTY_VALUE Strukturen im pPropertyEntriesIn-Parameter :

Eingabestruktur 1:

  • pPropertyEntriesIn[0]. Typ = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = Anwendungsname
  • pPropertyEntriesIn[0].u.strVal.size = Länge der Namenszeichenfolge
Eingabestruktur 2:
  • pPropertyEntriesIn[1]. Typ = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[1].u.strVal.pstrVal = Anwendungsparameter
  • pPropertyEntriesIn[1].u.strVal.size = Länge der Parameterzeichenfolge
Eingabestruktur 3:
  • pPropertyEntriesIn[2]. Typ = WTS_VALUE_TYPE_ULONG
  • pPropertyEntriesIn[2].u.ulVal = reserved
Übergeben Sie bei der Ausgabe die folgenden drei WTS_PROPERTY_VALUE Strukturen im pPropertyEntriesOut-Parameter . Wenn Sie die vom Remotedesktopdienstedienst übergebene Anwendung verwenden möchten, kopieren Sie die Eingabestrukturen 1 und 2 in die Ausgabestrukturen 1 und 2.

Ausgabestruktur 1:

  • pPropertyEntriesOut[0]. Typ = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[0].u.strVal.pstrVal = Befehlszeile einschließlich des Verzeichnisses
  • pPropertyEntriesOut[0].u.strVal.size = Länge der Befehlszeile
Ausgabestruktur 2:
  • pPropertyEntriesOut[1]. Typ = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[1].u.strVal.pstrVal = Anwendungsparameter
  • pPropertyEntriesOut[1].u.strVal.size = Länge der Parameterzeichenfolge
Ausgabestruktur 3:
  • pPropertyEntriesOut[2]. Typ = WTS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[2].u.ulVal = Beliebiger Wert außer Null zum Ausführen der Anwendung, null zum Beenden

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

Wird von WinLogon verwendet, um die Größe des Anmeldebildschirms zu bestimmen.

Der pPropertyEntriesIn-Parameter ist NULL.

Legen Sie den Parameter pPropertyEntriesOut wie folgt fest:

  • pPropertyEntriesOut[0]. Typ = WTS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = Bildschirmgröße
Wenn Sie die Standardbildschirmgröße nicht verwenden möchten, muss das Protokoll E_NOTIMPL zurückgeben.

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

Wird vom Remotedesktopdienstedienst verwendet, um den Namen der Remoteaudio-Enumerator-DLL abzufragen.

Der pPropertyEntriesIn-Parameter ist NULL.

Legen Sie den pPropertyEntriesOut-Parameter auf folgendes fest:

  • pPropertyEntriesOut[0]. Typ = WTS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[0].u.strVal.pstrVal = DLL-Name
Sie müssen den Arbeitsspeicher für pstrVal mithilfe der LocalAlloc-Funktion zuordnen.

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

Wird vom Remote Desktop Media Foundation-Plug-In verwendet, um die Senkenobjekte zu bestimmen, die für bestimmte Medienformate verwendet werden sollen.

Bei der Eingabe übergibt der RCM die folgende WTS_PROPERTY_VALUE-Struktur im pPropertyEntriesIn-Parameter :

Übergeben Sie bei der Ausgabe die folgende WTS_PROPERTY_VALUE-Struktur im pPropertyEntriesOut-Parameter .

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

Wird verwendet, um die dynamischen Zeitzoneninformationen aus einer Verbindung abzurufen.

Der pPropertyEntriesIn-Parameter ist NULL.

Übergeben Sie bei der Ausgabe die folgende WRDS_PROPERTY_VALUE-Struktur im pPropertyEntriesOut-Parameter :

[in] ulNumEntriesIn

Eine ganze Zahl, die die Anzahl der WTS_PROPERTY_VALUE Strukturen enthält, die im pPropertyEntriesIn-Argument übergeben werden.

[in] ulNumEntriesOut

Eine ganze Zahl, die die Anzahl WTS_PROPERTY_VALUE Strukturen enthält, die im pPropertyEntriesOut-Argument übergeben werden.

[in, optional] pPropertyEntriesIn

Mindestens eine WTS_PROPERTY_VALUE Strukturen, die zum Auffinden der angeforderten Eigenschafteninformationen verwendet werden können.

[out, optional] pPropertyEntriesOut

Mindestens eine WTS_PROPERTY_VALUE Strukturen, die die angeforderten Eigenschafteninformationen enthalten.

Rückgabewert

Keine

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008 R2
Zielplattform Windows
Kopfzeile wtsprotocol.h (include Wtsdefs.h)

Weitere Informationen

IWRdsProtocolConnection

IWRdsProtocolConnection::QueryProperty

IWTSProtocolConnection

TSMF_SUPPORT_DATA_IN

TSMF_SUPPORT_DATA_OUT

WRDS_DYNAMIC_TIME_ZONE_INFORMATION

WTS_PROPERTY_VALUE