Método IRDPSRAPISessionProperties::p ut_Property (rdpencomapi.h)

Artículo
08/25/2023

Establece u obtiene una propiedad de sesión con nombre.

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT put_Property(
  BSTR    PropertyName,
  VARIANT newVal
);

Parámetros

PropertyName

newVal

Valor devuelto

None

Observaciones

Puede establecer y obtener las siguientes propiedades. Los nombres de propiedad distinguen mayúsculas de minúsculas.

Nombre de propiedad	Descripción de la propiedad	Tipo de valor
"DrvConAttach"	Nota La propiedad DrvConAttach ya no está disponible para su uso a partir de Windows 10. Ya no hay un controlador reflejado para compartir. Hay dos modos para los datos adjuntos del controlador reflejado. La primera es el modo de carga dinámica. En este modo, el controlador reflejado se conectará inmediatamente después de que un asistente esté conectado a la sesión y tenga control de vista. El controlador reflejado se desasociará automáticamente cuando el último asistente abandone la sesión (o no haya asistentes con control de vista). El segundo modo es el modo de carga estática. En este modo, el controlador reflejado se carga inmediatamente después de abrir la sesión y no se descarga hasta que finaliza la sesión. Tenga en cuenta que, en ambos modos, es posible que el controlador se desasocie y se vuelva a adjuntar como resultado de eventos externos, como cambiar la resolución de pantalla o compartir la profundidad del color. Establezca esta propiedad en VARIANT_TRUE para el modo de datos adjuntos dinámicos y para VARIANT_FALSE para el modo de datos adjuntos estáticos. Tenga en cuenta que esta propiedad solo se puede establecer antes de llamar al método IRDPSRAPISharingSession::Open ; esta propiedad se convierte en de solo lectura después de llamar al método Open . El valor predeterminado es VARIANT_TRUE. Para escenarios de 1:1, como asistencia remota, debe usar el modo de carga dinámica, ya que puede tardar mucho tiempo entre el momento en que se abre la sesión y el momento en que se conectará un experto. En escenarios de 1:M (multiparty), debe usar el modo de carga estática porque la conexión y desasociación del controlador reflejado es bastante perjudicial y no debe realizarse a menos que haya una buena razón.	VT_BOOL
"PortId"	Puerto del agente de escucha para las conexiones entrantes desde el recurso compartidor. Esta propiedad también se puede establecer en el lado del visor, pero solo se usará para escuchar las conexiones en caso de una conexión inversa.	VT_I4
"PortProtocol"	Especifica la familia de protocolos para iniciar el agente de escucha en el recurso compartido. Los valores posibles son los siguientes: AF_UNSPEC Valor: 0 La familia de direcciones no está especificada. AF_INET Valor: 2 Familia de direcciones del Protocolo de Internet versión 4 (IPv4). AF_INET6 Valor: 23 Familia de direcciones del Protocolo de Internet versión 6 (IPv6).	VT_I4
"SetNetworkStream"	Puntero a una interfaz IUnknown que admite la interfaz IRDPSRAPITransportStream . Si se establece esta propiedad, el método Connect usará esta secuencia y omitirá el cadena de conexión pasado. Esta propiedad solo es válida para el lado del visor.	VT_UNKNOWN
"EnforceStrongEncryption"	Si esta propiedad tiene un valor de VARIANT_TRUE, el compartidor requiere que el visor use el cifrado compatible con el Estándar federal de procesamiento de información (FIPS) 140. El valor predeterminado es VARIANT_FALSE. Esta propiedad se convierte en de solo lectura después de llamar al método IRDPSRAPISharingSession::Open . Esta propiedad solo se puede establecer antes de llamar a ese método. La compatibilidad del visor con el cumplimiento de FIPS 140 se agregó en Windows 10, versión 1709. El recurso compartidor rechaza las conexiones de las versiones del visor anteriores a Windows 10, versión 1709. Esta propiedad solo es válida para el lado del recurso compartido.	VT_BOOL
"FrameCaptureIntervalInMs"	Especifica el intervalo de captura de fotogramas. De forma predeterminada, el intervalo de captura de fotogramas es de 33 milisegundos, que corresponde a 30 fotogramas por segundo. Puede usar esta propiedad para optimizar el rendimiento. Si no es necesario realizar actualizaciones de pantalla con tanta frecuencia, se puede aumentar el intervalo de captura. Por ejemplo, un valor de 400 milisegundos da como resultado 2,5 fotogramas por segundo. Esta propiedad solo es válida para el lado del recurso compartido.	VT_I4
"DefaultAttendeeControlLevel"	Especifica el nivel de control predeterminado para los asistentes. De forma predeterminada, este valor es CTRL_LEVEL_NONE (ninguno). Puede cambiar este valor a CTRL_LEVEL_VIEW (vista). El nivel de control predeterminado no se puede establecer en interactivo. Esta propiedad solo es válida para el lado del recurso compartido.	VT_I4
"EnableClipboardRedirect"	Si esta propiedad tiene un valor de VARIANT_TRUE, se activa el Portapapeles entre el compartidor y el visor. El valor predeterminado es VARIANT_FALSE. Para usar el uso compartido del Portapapeles, la sesión debe estar en modo interactivo. Solo una conexión puede compartir el Portapapeles. La conexión que adquirió más recientemente el control de entrada toma el uso compartido del Portapapeles. El uso compartido del Portapapeles para cualquier conexión anterior se deshabilita automáticamente. Esta propiedad solo se puede usar para aplicaciones de escritorio. Esta propiedad solo es válida para el lado del recurso compartido. Esta propiedad está disponible a partir de Windows 10, versión 1511.	VT_BOOL
"SetClipboardRedirectCallback"	Especifica un puntero IUnknown a una instancia de IRDPSRAPIClipboardUseEvents que recibe una devolución de llamada cada vez que se intenta copiar desde el equipo del compartidor al visor. Esta propiedad solo es relevante si está habilitado el uso compartido del Portapapeles. Esta propiedad se convierte en de solo lectura después de llamar al método IRDPSRAPISharingSession::Open . Esta propiedad solo se puede establecer antes de llamar a ese método. Esta propiedad solo se puede usar para aplicaciones de escritorio. Esta propiedad solo es válida para el lado del recurso compartido. Esta propiedad está disponible a partir de Windows 10, versión 1511.	VT_UNKNOWN
"EnabledTransports"	Especifica los transportes que se van a habilitar. Un valor de 3 admite TCP y UDP. El valor predeterminado es 1, que es solo TCP. Esta propiedad se convierte en de solo lectura después de llamar al método IRDPSRAPISharingSession::Open . Solo puede establecer esta propiedad antes de llamar a ese método. Esta propiedad está disponible a partir de Windows 10, versión 1803. Esta propiedad solo es válida para el lado del recurso compartido.	VT_I4

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	rdpencomapi.h
Archivo DLL	RdpEncom.dll

Consulte también

IRDPSRAPISessionProperties

Compartir a través de