IRDPSRAPISessionProperties ::p ut_Property, méthode (rdpencomapi.h)

Article
08/25/2023

Définit ou obtient une propriété de session nommée.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT put_Property(
  BSTR    PropertyName,
  VARIANT newVal
);

Paramètres

PropertyName

newVal

Valeur de retour

None

Remarques

Vous pouvez définir et obtenir les propriétés suivantes. Les noms des propriétés respectent la casse.

Nom de la propriété	Description de la propriété	Type de valeur
« DrvConAttach »	Note La propriété DrvConAttach n’est plus disponible depuis Windows 10. Il n’existe plus de pilote miroir pour le partage. Il existe deux modes pour la pièce jointe du pilote miroir. Le premier est le mode de chargement dynamique. Dans ce mode, le pilote miroir est attaché immédiatement après qu’un participant est connecté à la session et qu’il dispose d’un contrôle d’affichage. Le pilote miroir est automatiquement détaché lorsque le dernier participant quitte la session (ou il n’y a aucun participant disposant d’un contrôle d’affichage). Le deuxième mode est le mode de charge statique. Dans ce mode, le pilote miroir est chargé immédiatement après l’ouverture de la session et n’est pas déchargé tant que la session n’est pas terminée. Notez que dans les deux modes, le pilote peut être détaché et attaché à nouveau à la suite d’événements externes tels que la modification de la résolution de l’écran ou le partage de la profondeur de couleur. Définissez cette propriété sur VARIANT_TRUE pour le mode de pièce jointe dynamique et sur VARIANT_FALSE pour le mode de pièce jointe statique. Notez que vous pouvez définir cette propriété uniquement avant d’appeler la méthode IRDPSRAPISharingSession ::Open ; cette propriété devient en lecture seule après l’appel de la méthode Open . La valeur par défaut est VARIANT_TRUE. Pour les scénarios 1 :1 tels que l’assistance à distance, vous devez utiliser le mode de charge dynamique, car cela peut prendre beaucoup de temps entre le moment où la session est ouverte et le moment où un expert se connecte. Pour les scénarios 1 :M (multiparty), vous devez utiliser le mode de charge statique, car l’attachement et le détachement du pilote miroir sont très perturbants et ne doivent pas être effectués à moins qu’il y ait une bonne raison.	VT_BOOL
« PortId »	Port de l’écouteur pour les connexions entrantes à partir du partageur. Cette propriété peut également être définie côté visionneuse, mais elle est utilisée uniquement pour écouter les connexions en cas de connexion inverse.	VT_I4
« PortProtocol »	Spécifie la famille de protocoles pour démarrer l’écouteur sur le partageur. Les valeurs possibles sont les suivantes : AF_UNSPEC Valeur : 0 La famille d’adresses n’est pas spécifiée. AF_INET Valeur : 2 Famille d’adresses IPv4 (Internet Protocol version 4). AF_INET6 Valeur : 23 Famille d’adresses IPv6 (Internet Protocol version 6).	VT_I4
« SetNetworkStream »	Pointeur vers une interface IUnknown qui prend en charge l’interface IRDPSRAPITransportStream . Si cette propriété est définie, la méthode Connect utilise ce flux et ignore le chaîne de connexion passé. Cette propriété est valide uniquement côté visionneuse.	VT_UNKNOWN
« EnforceStrongEncryption »	Si cette propriété a la valeur VARIANT_TRUE, le partageur exige que la visionneuse utilise le chiffrement conforme à la norme FIPS (Federal Information Processing Standard) 140. La valeur par défaut est VARIANT_FALSE. Cette propriété devient en lecture seule après l’appel de la méthode IRDPSRAPISharingSession ::Open . Vous pouvez définir cette propriété uniquement avant d’appeler cette méthode. La prise en charge de la visionneuse pour la conformité FIPS 140 a été ajoutée dans Windows 10, version 1709. Le partageur rejette les connexions des versions de visionneuse antérieures à Windows 10, version 1709. Cette propriété est valide pour le côté partageur uniquement.	VT_BOOL
« FrameCaptureIntervalInMs »	Spécifie l’intervalle de capture d’images. Par défaut, l’intervalle de capture d’images est de 33 millisecondes, ce qui correspond à 30 images par seconde. Vous pouvez utiliser cette propriété pour optimiser les performances. Si les mises à jour de l’écran n’ont pas besoin d’être effectuées fréquemment, l’intervalle de capture peut être augmenté. Par exemple, une valeur de 400 millisecondes génère 2,5 images par seconde. Cette propriété est valide pour le côté partageur uniquement.	VT_I4
« DefaultAttendeeControlLevel »	Spécifie le niveau de contrôle par défaut pour les participants. Par défaut, cette valeur est CTRL_LEVEL_NONE (aucun). Vous pouvez modifier cette valeur en CTRL_LEVEL_VIEW (affichage). Le niveau de contrôle par défaut ne peut pas être défini sur interactif. Cette propriété est valide pour le côté partageur uniquement.	VT_I4
« EnableClipboardRedirect »	Si cette propriété a la valeur VARIANT_TRUE, le Presse-papiers entre le partageur et la visionneuse est activé. La valeur par défaut est VARIANT_FALSE. Pour utiliser le partage du Presse-papiers, la session doit être en mode interactif. Une seule connexion peut partager le Presse-papiers. La connexion qui a récemment acquis le contrôle d’entrée prend le contrôle du presse-papiers. Le partage du Presse-papiers pour toute connexion précédente est automatiquement désactivé. Cette propriété ne peut être utilisée que pour les applications de bureau. Cette propriété est valide pour le côté partageur uniquement. Cette propriété est disponible à partir de Windows 10, version 1511.	VT_BOOL
« SetClipboardRedirectCallback »	Spécifie un pointeur IUnknown vers un instance d’IRDPSRAPIClipboardUseEvents qui reçoit un rappel chaque fois qu’une copie de l’ordinateur partageur vers la visionneuse est tentée. Cette propriété n’est pertinente que si le partage du Presse-papiers est activé. Cette propriété devient en lecture seule après l’appel de la méthode IRDPSRAPISharingSession ::Open . Vous pouvez définir cette propriété uniquement avant d’appeler cette méthode. Cette propriété ne peut être utilisée que pour les applications de bureau. Cette propriété est valide pour le côté partageur uniquement. Cette propriété est disponible à partir de Windows 10, version 1511.	VT_UNKNOWN
« EnabledTransports »	Spécifie les transports à activer. La valeur 3 prend en charge TCP et UDP. La valeur par défaut est 1, qui est TCP uniquement. Cette propriété devient en lecture seule après l’appel de la méthode IRDPSRAPISharingSession ::Open . Vous pouvez définir cette propriété uniquement avant d’appeler cette méthode. Cette propriété est disponible à partir de Windows 10, version 1803. Cette propriété est valide uniquement pour le côté sharer.	VT_I4

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	rdpencomapi.h
DLL	RdpEncom.dll

Voir aussi

IRDPSRAPISessionProperties

Partager via