Metodo IWTSProtocolConnection::QueryProperty (wtsprotocol.h)

Articolo
08/28/2023

[IWTSProtocolConnection::QueryProperty non è più disponibile per l'uso a partire da Windows Server 2012. Usare invece IWRdsProtocolConnection::QueryProperty.]

Recupera la proprietà specificata 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]  PWTS_PROPERTY_VALUE pPropertyEntriesIn,
  [out, optional] PWTS_PROPERTY_VALUE pPropertyEntriesOut
);

Parametri

[in] QueryType

GUID che specifica la proprietà . Questo può essere uno dei valori seguenti.

WTS_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 WTS_PROPERTY_VALUE nel parametro pPropertyEntriesIn :

Struttura di input 1:

pPropertyEntriesIn[0]. Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesIn[0].u.strVal.pstrVal = nome applicazione
pPropertyEntriesIn[0].u.strVal.size = lunghezza della stringa del nome

Struttura di input 2:

pPropertyEntriesIn[1]. Type = WTS_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]. Tipo = WTS_VALUE_TYPE_ULONG
pPropertyEntriesIn[2].u.ulVal = riservato

Nell'output passare le tre WTS_PROPERTY_VALUE strutture seguenti nel parametro pPropertyEntriesOut . Se si vuole usare l'applicazione passata dal servizio Servizi Desktop remoto, copiare strutture di input 1 e 2 in strutture di output 1 e 2.

Struttura di output 1:

pPropertyEntriesOut[0]. Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[0].u.strVal.pstrVal = riga di comando inclusa la directory
pPropertyEntriesOut[0].u.strVal.size = lunghezza della riga di comando

Struttura di output 2:

pPropertyEntriesOut[1]. Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[1].u.strVal.pstrVal = parametri dell'applicazione
pPropertyEntriesOut[1].u.strVal.size = lunghezza della stringa di parametro

Struttura di output 3:

pPropertyEntriesOut[2]. Tipo = WTS_VALUE_TYPE_ULONG
pPropertyEntriesOut[2].u.ulVal = Qualsiasi valore diverso da zero per eseguire l'applicazione, zero da arrestare

WTS_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]. Tipo = WTS_VALUE_TYPE_ULONG
pPropertyEntriesOut[0].u.ulVal = dimensioni dello schermo

Se non si vuole usare le dimensioni predefinite dello schermo, il protocollo deve restituire E_NOTIMPL.

WTS_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 = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[0].u.strVal.pstrVal = nome DLL

È necessario allocare la memoria per pstrVal usando la funzione LocalAlloc .

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

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

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

pPropertyEntriesOut[0]. Tipo = WTS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = TSMF_SUPPORT_DATA_IN
pPropertyEntriesOut[0].u.bVal.size = Dimensioni di TSMF_SUPPORT_DATA_IN

Nell'output passare la struttura di WTS_PROPERTY_VALUE seguente nel parametro pPropertyEntriesOut .

pPropertyEntriesOut[0]. Tipo = WTS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbValVal = TSMF_SUPPORT_DATA_OUT
pPropertyEntriesOut[0].u.bVal.size = Dimensioni di TSMF_SUPPORT_DATA_OUT

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

Usato per recuperare le informazioni del fuso orario dinamico da una connessione.

Il parametro pPropertyEntriesIn sarà NULL.

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

pPropertyEntriesOut[0]. Tipo = WRDS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = WRDS_DYNAMIC_TIME_ZONE_INFORMATION struttura
pPropertyEntriesOut[0].u.bVal.size = Dimensioni della struttura WRDS_DYNAMIC_TIME_ZONE_INFORMATION

[in] ulNumEntriesIn

Intero contenente il numero di strutture WTS_PROPERTY_VALUE passate nell'argomento pPropertyEntriesIn .

[in] ulNumEntriesOut

Intero contenente il numero di strutture WTS_PROPERTY_VALUE passate nell'argomento pPropertyEntriesOut .

[in, optional] pPropertyEntriesIn

Una o più strutture WTS_PROPERTY_VALUE che possono essere usate per trovare le informazioni sulla proprietà richieste.

[out, optional] pPropertyEntriesOut

Una o più strutture WTS_PROPERTY_VALUE che contengono le informazioni sulla proprietà richieste.

Valore restituito

nessuno

Requisiti

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