Méthode IWTSProtocolConnection ::QueryProperty (wtsprotocol.h)

Article
03/13/2024

[IWTSProtocolConnection ::QueryProperty n’est plus disponible à partir de Windows Server 2012. Utilisez plutôt IWRdsProtocolConnection ::QueryProperty.]

Récupère la propriété spécifiée à partir du protocole. Cette méthode peut être utilisée par d’autres modules Windows pour demander des données ou envoyer des données au protocole.

Syntaxe

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

Paramètres

[in] QueryType

GUID qui spécifie la propriété . Il peut s’agir de l’une des valeurs suivantes.

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

Envoyé par le service Services Bureau à distance pour déterminer si une application initiale doit être autorisée à s’exécuter.

Lors de l’entrée, le service Services Bureau à distance transmet trois structures WTS_PROPERTY_VALUE dans le paramètre pPropertyEntriesIn :

Structure d’entrée 1 :

pPropertyEntriesIn[0]. Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesIn[0].u.strVal.pstrVal = nom de l’application
pPropertyEntriesIn[0].u.strVal.size = longueur de la chaîne de nom

Structure d’entrée 2 :

pPropertyEntriesIn[1]. Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesIn[1].u.strVal.pstrVal = paramètres d’application
pPropertyEntriesIn[1].u.strVal.size = longueur de la chaîne de paramètre

Structure d’entrée 3 :

pPropertyEntriesIn[2]. Type = WTS_VALUE_TYPE_ULONG
pPropertyEntriesIn[2].u.ulVal = réservé

À la sortie, transmettez les trois structures WTS_PROPERTY_VALUE suivantes dans le paramètre pPropertyEntriesOut . Si vous souhaitez utiliser l’application transmise par le service Services Bureau à distance , copiez les structures d’entrée 1 et 2 dans les structures de sortie 1 et 2.

Structure de sortie 1 :

pPropertyEntriesOut[0]. Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[0].u.strVal.pstrVal = ligne de commande incluant le répertoire
pPropertyEntriesOut[0].u.strVal.size = longueur de la ligne de commande

Structure de sortie 2 :

pPropertyEntriesOut[1]. Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[1].u.strVal.pstrVal = paramètres d’application
pPropertyEntriesOut[1].u.strVal.size = longueur de la chaîne de paramètre

Structure de sortie 3 :

pPropertyEntriesOut[2]. Type = WTS_VALUE_TYPE_ULONG
pPropertyEntriesOut[2].u.ulVal = Toute valeur autre que zéro pour exécuter l’application, zéro à arrêter

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

Utilisé par WinLogon pour déterminer la taille de l’écran d’ouverture de session.

Le paramètre pPropertyEntriesIn sera NULL.

Définissez le paramètre pPropertyEntriesOut sur les éléments suivants :

pPropertyEntriesOut[0]. Type = WTS_VALUE_TYPE_ULONG
pPropertyEntriesOut[0].u.ulVal = taille de l’écran

Si vous ne souhaitez pas utiliser la taille d’écran par défaut, le protocole doit retourner E_NOTIMPL.

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

Utilisé par le service Services Bureau à distance pour interroger le nom de la DLL d’énumérateur audio distant.

Le paramètre pPropertyEntriesIn sera NULL.

Définissez le paramètre pPropertyEntriesOut sur les éléments suivants :

pPropertyEntriesOut[0]. Type = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[0].u.strVal.pstrVal = nom de la DLL

Vous devez allouer la mémoire pour pstrVal à l’aide de la fonction LocalAlloc .

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

Utilisé par le plug-in Remote Desktop Media Foundation pour déterminer les objets récepteur à utiliser pour des formats multimédias spécifiques.

Lors de l’entrée, le RCM transmet la structure WTS_PROPERTY_VALUE suivante dans le paramètre pPropertyEntriesIn :

pPropertyEntriesOut[0]. Type = WTS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = TSMF_SUPPORT_DATA_IN
pPropertyEntriesOut[0].u.bVal.size = Taille de TSMF_SUPPORT_DATA_IN

À la sortie, transmettez la structure WTS_PROPERTY_VALUE suivante dans le paramètre pPropertyEntriesOut .

pPropertyEntriesOut[0]. Type = WTS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = TSMF_SUPPORT_DATA_OUT
pPropertyEntriesOut[0].u.bVal.size = Taille de TSMF_SUPPORT_DATA_OUT

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

Utilisé pour récupérer les informations de fuseau horaire dynamique à partir d’une connexion.

Le paramètre pPropertyEntriesIn sera NULL.

À la sortie, transmettez la structure WRDS_PROPERTY_VALUE suivante dans le paramètre pPropertyEntriesOut :

pPropertyEntriesOut[0]. Type = WRDS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = structure WRDS_DYNAMIC_TIME_ZONE_INFORMATION
pPropertyEntriesOut[0].u.bVal.size = Taille de WRDS_DYNAMIC_TIME_ZONE_INFORMATION structure

[in] ulNumEntriesIn

Entier qui contient le nombre de structures WTS_PROPERTY_VALUE passées dans l’argument pPropertyEntriesIn .

[in] ulNumEntriesOut

Entier qui contient le nombre de structures WTS_PROPERTY_VALUE passées dans l’argument pPropertyEntriesOut .

[in, optional] pPropertyEntriesIn

Une ou plusieurs structures WTS_PROPERTY_VALUE qui peuvent être utilisées pour trouver les informations de propriété demandées.

[out, optional] pPropertyEntriesOut

Une ou plusieurs structures WTS_PROPERTY_VALUE qui contiennent les informations de propriété demandées.

Valeur de retour

None

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 R2
Plateforme cible	Windows
En-tête	wtsprotocol.h (inclure Wtsdefs.h)