Partager via

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

  • Article

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

Syntaxe

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

Paramètres

[in] QueryType

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

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

Envoyé par le service 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 WRDS_PROPERTY_VALUE dans le paramètre pPropertyEntriesIn :

Structure d’entrée 1 :

  • pPropertyEntriesIn[0].Type = WRDS_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 = WRDS_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 = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesIn[2].u.ulVal = Réservés au
Lors de la sortie, transmettez les trois structures WRDS_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 = WRDS_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 = WRDS_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 = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[2].u.ulVal = Toute valeur autre que zéro pour exécuter l’application, zéro pour arrêter

WRDS_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 est NULL.

Définissez le paramètre pPropertyEntriesOut sur ce qui suit :

  • pPropertyEntriesOut[0].Type = WRDS_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.

WRDS_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 est NULL.

Définissez le paramètre pPropertyEntriesOut sur ce qui suit :

  • pPropertyEntriesOut[0].Type = WRDS_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 .

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

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

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_BINARY
  • pPropertyEntriesOut[0].u.bVal.pbVal = TSMF_SUPPORT_DATA_IN structure
  • pPropertyEntriesOut[0].u.bVal.size = taille de TSMF_SUPPORT_DATA_IN structure
À la sortie, transmettez la structure de WRDS_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 est NULL.

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

Permet de déterminer si le curseur doit être désactivé.

Le paramètre pPropertyEntriesIn est NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 1 pour désactiver le clignotement du curseur, 0 sinon

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

Utilisé par le service Bureau à distance pour déterminer le mode de reconnexion à utiliser.

Le paramètre pPropertyEntriesIn est NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 pour désactiver la reconnexion rapide, 1 pour la reconnexion rapide de base, 2 pour la reconnexion rapide améliorée

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

Utilisé par le service Services Bureau à distance pendant la reconnexion rapide améliorée pour récupérer le SID utilisateur selon lequel les sessions à reconnecter sont filtrées.

Le paramètre pPropertyEntriesIn est NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = SID utilisateur à utiliser comme filtre de session
  • pPropertyEntriesIn[0].u.strVal.size = Longueur du SID utilisateur, y compris le caractère de fin null
Vous devez allouer la mémoire pour pstrVal à l’aide de la fonction LocalAlloc .

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

Le service Services Bureau à distance détermine si ShellAppRuntime.exe sera lancé avant les interpréteurs de commandes personnalisés lors de la création de la session. ShellAppRuntime.exe implémente la prise en charge des applications universelles pour les interpréteurs de commandes personnalisés. Cela n’est pas activé par défaut (ce qui équivaut à passer zéro). Cette fonctionnalité est disponible dans les versions Windows server 2019 et ultérieures ou Windows 10 build multisession 18950 et ultérieures.

Le paramètre pPropertyEntriesIn est NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 pour ne pas activer la prise en charge des applications universelles pour les interpréteurs de commandes personnalisés, 1 Activer la prise en charge des applications universelles pour les interpréteurs de commandes personnalisés

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

Permet de déterminer si une invite d’avertissement de déconnexion s’affiche lorsque le minuteur d’inactivité expire.

Le paramètre pPropertyEntriesIn est NULL.

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

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 pour désactiver l’invite d’avertissement, 1 pour l’activer

[in] ulNumEntriesIn

Nombre d’entrées dans le tableau pPropertyEntriesIn .

[in] ulNumEntriesOut

Nombre d’entrées dans le tableau pPropertyEntriesOut .

[in, optional] pPropertyEntriesIn

Tableau de pointeurs vers WRDS_PROPERTY_VALUE structures qui peuvent être utilisés pour vous aider à trouver les informations de propriété demandées.

[out, optional] pPropertyEntriesOut

Tableau de pointeurs vers WRDS_PROPERTY_VALUE structures qui reçoivent les valeurs de propriété demandées.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

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

Voir aussi

IWRdsProtocolConnection