Méthode IWTSProtocolConnection ::QueryProperty (wtsprotocol.h)
[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
- 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
- pPropertyEntriesIn[2]. Type = WTS_VALUE_TYPE_ULONG
- pPropertyEntriesIn[2].u.ulVal = réservé
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
- 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
- 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
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
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
- 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) |
Voir aussi
IWRdsProtocolConnection ::QueryProperty
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour