Freigeben über

IWRdsProtocolConnection::QueryProperty-Methode (wtsprotocol.h)

  • Artikel

Ruft einen Eigenschaftswert 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]  PWRDS_PROPERTY_VALUE pPropertyEntriesIn,
  [out, optional] PWRDS_PROPERTY_VALUE pPropertyEntriesOut
);

Parameter

[in] QueryType

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

WRDS_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 WRDS_PROPERTY_VALUE Strukturen im pPropertyEntriesIn-Parameter :

Eingabestruktur 1:

  • pPropertyEntriesIn[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = Anwendungsname
  • pPropertyEntriesIn[0].u.strVal.size = Länge der Namenszeichenfolge
Eingabestruktur 2:
  • pPropertyEntriesIn[1].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[1].u.strVal.pstrVal = Anwendungsparameter
  • pPropertyEntriesIn[1].u.strVal.size = Länge der Parameterzeichenfolge
Eingabestruktur 3:
  • pPropertyEntriesIn[2].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesIn[2].u.ulVal = Reserviert
Übergeben Sie in der Ausgabe die folgenden drei WRDS_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].Type = WRDS_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].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[1].u.strVal.pstrVal = Anwendungsparameter
  • pPropertyEntriesOut[1].u.strVal.size = Länge der Parameterzeichenfolge
Ausgabestruktur 3:
  • pPropertyEntriesOut[2].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[2].u.ulVal = Jeder andere Wert als null zum Ausführen der Anwendung, null zum Beenden

WRDS_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].Type = WRDS_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.

WRDS_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 Parameter pPropertyEntriesOut wie folgt fest:

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

WRDS_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 WRDS_PROPERTY_VALUE-Struktur im pPropertyEntriesIn-Parameter :

Übergeben Sie bei der Ausgabe die folgende WRDS_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 :

Wird verwendet, um zu bestimmen, ob der Cursor blinken deaktiviert werden soll.

Der pPropertyEntriesIn-Parameter ist NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 1 zum Deaktivieren des Cursorblindschlags, 0 andernfalls 0

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

Wird vom Remotedesktopdienstedienst verwendet, um den Modus der erneuten Verbindung zu bestimmen.

Der pPropertyEntriesIn-Parameter ist NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 zum Deaktivieren der schnellen Wiederverbindung, 1 für "Basic Fast Reconnect" und 2 für "Enhanced Fast Reconnect"

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

Wird vom Remotedesktopdienst während der erweiterten Schnellen Wiederverbindung verwendet, um die Benutzer-SID abzurufen, mit der Sitzungen gefiltert werden, mit denen die Verbindung wiederhergestellt werden soll.

Der pPropertyEntriesIn-Parameter ist NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = Benutzer-SID, die als Sitzungsfilter verwendet werden soll
  • pPropertyEntriesIn[0].u.strVal.size = Länge der Benutzer-SID einschließlich des Null-Endzeichens
Sie müssen den Arbeitsspeicher für pstrVal mithilfe der LocalAlloc-Funktion zuordnen.

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

Wird vom Remotedesktopdienstedienst verwendet, bestimmen Sie, ob ShellAppRuntime.exe vor benutzerdefinierten Shells während der Sitzungserstellung gestartet wird. ShellAppRuntime.exe implementiert universelle App-Unterstützung für benutzerdefinierte Shells. Dies ist standardmäßig nicht aktiviert (entspricht dem Übergeben von null). Dies ist in Windows-Versionen verfügbar, die Server 2019 und höher oder Windows 10 Build 18950 und höher mit mehreren Sitzungen sind.

Der pPropertyEntriesIn-Parameter ist NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0, um die Unterstützung von universellen Apps für benutzerdefinierte Shells nicht zu aktivieren, 1 Unterstützung für universelle Apps für benutzerdefinierte Shells aktivieren

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

Wird verwendet, um zu bestimmen, ob eine Abmeldungswarnung angezeigt wird, wenn der Leerlaufzeitgeber abläuft.

Der pPropertyEntriesIn-Parameter ist NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 zum Deaktivieren der Warnungsaufforderung, 1 zum Aktivieren

[in] ulNumEntriesIn

Die Anzahl der Einträge im pPropertyEntriesIn-Array .

[in] ulNumEntriesOut

Die Anzahl der Einträge im pPropertyEntriesOut-Array .

[in, optional] pPropertyEntriesIn

Ein Array von Zeigern auf WRDS_PROPERTY_VALUE Strukturen, die verwendet werden können, um die angeforderten Eigenschafteninformationen zu finden.

[out, optional] pPropertyEntriesOut

Ein Array von Zeigern auf WRDS_PROPERTY_VALUE Strukturen, die die angeforderten Eigenschaftswerte empfangen.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

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

Weitere Informationen

IWRdsProtocolConnection