Condividi tramite

Metodo IWRdsProtocolConnection::QueryProperty (wtsprotocol.h)

  • Articolo

Recupera un valore della proprietà dal protocollo. Questo metodo può essere usato da altri moduli di Windows per richiedere dati da o inviare dati al protocollo.

Sintassi

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

Parametri

[in] QueryType

GUID che specifica la proprietà richiesta. Può trattarsi di uno dei valori seguenti.

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

Inviato dal servizio Servizi Desktop remoto per determinare se un'applicazione iniziale deve essere consentita per l'esecuzione.

In input, il servizio Servizi Desktop remoto passa tre strutture WRDS_PROPERTY_VALUE nel parametro pPropertyEntriesIn :

Struttura di input 1:

  • pPropertyEntriesIn[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = nome dell'applicazione
  • pPropertyEntriesIn[0].u.strVal.size = lunghezza della stringa del nome
Struttura di input 2:
  • pPropertyEntriesIn[1].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[1].u.strVal.pstrVal = parametri dell'applicazione
  • pPropertyEntriesIn[1].u.strVal.size = lunghezza della stringa del parametro
Struttura di input 3:
  • pPropertyEntriesIn[2].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesIn[2].u.ulVal = Riservati
Nell'output passare le tre strutture di WRDS_PROPERTY_VALUE seguenti nel parametro pPropertyEntriesOut . Se si vuole usare l'applicazione passata dal servizio Servizi Desktop remoto, copiare le strutture di input 1 e 2 nelle strutture di output 1 e 2.

Struttura di output 1:

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[0].u.strVal.pstrVal = riga di comando che include la directory
  • pPropertyEntriesOut[0].u.strVal.size = lunghezza della riga di comando
Struttura di output 2:
  • pPropertyEntriesOut[1].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[1].u.strVal.pstrVal = parametri dell'applicazione
  • pPropertyEntriesOut[1].u.strVal.size = lunghezza della stringa del parametro
Struttura di output 3:
  • pPropertyEntriesOut[2].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[2].u.ulVal = Qualsiasi valore diverso da zero per eseguire l'applicazione, zero da arrestare

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

Usato da WinLogon per determinare le dimensioni della schermata di accesso.

Il parametro pPropertyEntriesIn sarà NULL.

Impostare il parametro pPropertyEntriesOut sul seguente:

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = dimensioni dello schermo
Se non si desidera utilizzare le dimensioni predefinite dello schermo, il protocollo deve restituire E_NOTIMPL.

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

Usato dal servizio Servizi Desktop remoto per eseguire query sul nome della DLL dell'enumeratore audio remoto.

Il parametro pPropertyEntriesIn sarà NULL.

Impostare il parametro pPropertyEntriesOut sul seguente:

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[0].u.strVal.pstrVal = Nome DLL
È necessario allocare la memoria per pstrVal usando la funzione LocalAlloc .

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

Utilizzato dal plug-in Desktop remoto Media Foundation per determinare gli oggetti sink da usare per formati multimediali specifici.

In input, RCM passa la struttura di WRDS_PROPERTY_VALUE seguente nel parametro pPropertyEntriesIn :

Nell'output passare la struttura di WRDS_PROPERTY_VALUE seguente nel parametro pPropertyEntriesOut :

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

Utilizzato per recuperare le informazioni sul fuso orario dinamico da una connessione.

Il parametro pPropertyEntriesIn sarà NULL.

Nell'output passare la struttura di WRDS_PROPERTY_VALUE seguente nel parametro pPropertyEntriesOut :

Utilizzato per determinare se il lampeggiare del cursore deve essere disabilitato.

Il parametro pPropertyEntriesIn sarà NULL.

Nell'output passare la struttura di WRDS_PROPERTY_VALUE seguente nel parametro pPropertyEntriesOut :

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 1 per disabilitare il lampeggiare del cursore, 0 in caso contrario

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

Utilizzato dal servizio Servizi Desktop remoto per determinare la modalità di riconnessione da usare.

Il parametro pPropertyEntriesIn sarà NULL.

Nell'output passare la struttura di WRDS_PROPERTY_VALUE seguente nel parametro pPropertyEntriesOut :

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 per disabilitare la riconnessione rapida, 1 per La riconnessione rapida basic, 2 per La riconnessione rapida avanzata

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

Usato dal servizio Servizi Desktop remoto durante la riconnessione rapida avanzata per recuperare il SID utente in base al quale le sessioni a cui riconnettersi vengono filtrate.

Il parametro pPropertyEntriesIn sarà NULL.

Nell'output passare la struttura di WRDS_PROPERTY_VALUE seguente nel parametro pPropertyEntriesOut :

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = SID utente da usare come filtro di sessione
  • pPropertyEntriesIn[0].u.strVal.size = Lunghezza del SID utente che include il carattere di terminazione Null
È necessario allocare la memoria per pstrVal usando la funzione LocalAlloc .

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

Usato dal servizio Servizi Desktop remoto determina se ShellAppRuntime.exe verrà avviato prima di qualsiasi shell personalizzata durante la creazione della sessione. ShellAppRuntime.exe implementa il supporto delle app universali per le shell personalizzate. Questa opzione non è abilitata per impostazione predefinita (equivalente al passaggio di zero). Questa funzionalità è disponibile nelle versioni di Windows server 2019 e successive o successive o Windows 10 build multisessione 18950 e successive.

Il parametro pPropertyEntriesIn sarà NULL.

Nell'output passare la struttura di WRDS_PROPERTY_VALUE seguente nel parametro pPropertyEntriesOut :

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 per non abilitare il supporto delle app universali per le shell personalizzate, 1 Abilitare il supporto delle app universali per le shell personalizzate

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

Consente di determinare se viene visualizzata una richiesta di avviso di disconnessione alla scadenza del timer inattivo.

Il parametro pPropertyEntriesIn sarà NULL.

Nell'output passare la struttura di WRDS_PROPERTY_VALUE seguente nel parametro pPropertyEntriesOut :

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 per disabilitare il prompt degli avvisi, 1 per abilitarlo

[in] ulNumEntriesIn

Numero di voci nella matrice pPropertyEntriesIn .

[in] ulNumEntriesOut

Numero di voci nella matrice pPropertyEntriesOut .

[in, optional] pPropertyEntriesIn

Matrice di puntatori per WRDS_PROPERTY_VALUE strutture che possono essere usate per trovare le informazioni sulla proprietà richieste.

[out, optional] pPropertyEntriesOut

Matrice di puntatori per WRDS_PROPERTY_VALUE strutture che ricevono i valori delle proprietà richieste.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2012
Piattaforma di destinazione Windows
Intestazione wtsprotocol.h (include Wtsdefs.h)

Vedi anche

IWRdsProtocolConnection