Partager via


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
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 :

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

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 :

[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

IWRdsProtocolConnection ::QueryProperty

IWTSProtocolConnection

TSMF_SUPPORT_DATA_IN

TSMF_SUPPORT_DATA_OUT

WRDS_DYNAMIC_TIME_ZONE_INFORMATION

WTS_PROPERTY_VALUE