Metodo IRDPSRAPISessionProperties::p ut_Property (rdpencomapi.h)

Articolo
08/25/2023

Imposta o ottiene una proprietà sessione denominata.

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT put_Property(
  BSTR    PropertyName,
  VARIANT newVal
);

Parametri

PropertyName

newVal

Valore restituito

nessuno

Osservazioni

È possibile impostare e ottenere le proprietà seguenti. I nomi delle proprietà sono distinzione tra maiuscole e minuscole.

Nome proprietà	Descrizione della proprietà	Tipo di valore
"DrvConAttach"	Nota La proprietà DrvConAttach non è più disponibile per l'uso a partire da Windows 10. Non esiste più un driver mirror per la condivisione. Esistono due modalità per l'allegato del driver mirror. Il primo è la modalità di caricamento dinamica. In questa modalità, il driver mirror verrà collegato immediatamente dopo che un partecipante è connesso alla sessione e ha il controllo di visualizzazione. Il driver mirror verrà scollegato automaticamente quando l'ultimo partecipante lascia la sessione (o non sono presenti partecipanti con controllo di visualizzazione). La seconda modalità è la modalità di caricamento statica. In questa modalità il driver mirror viene caricato immediatamente dopo l'apertura della sessione e non viene scaricato fino al termine della sessione. Si noti che in entrambe le modalità il driver potrebbe essere scollegato e ricollegato come risultato di eventi esterni come la modifica della risoluzione dello schermo o la condivisione della profondità del colore. Impostare questa proprietà su VARIANT_TRUE per la modalità allegato dinamico e su VARIANT_FALSE per la modalità allegato statica. Si noti che è possibile impostare questa proprietà solo prima di chiamare il metodo IRDPSRAPISharingSession::Open ; questa proprietà diventa di sola lettura dopo che viene chiamato il metodo Open . Il valore predefinito è VARIANT_TRUE. Per gli scenari 1:1, ad esempio Assistenza remota, è consigliabile usare la modalità di caricamento dinamica perché può richiedere molto tempo tra il momento in cui la sessione viene aperta e il momento in cui un esperto si connetterà. Per gli scenari 1:M (multiparty), è consigliabile usare la modalità di caricamento statica perché il collegamento e il scollegamento del driver mirror non devono essere eseguiti a meno che non vi sia un buon motivo.	VT_BOOL
"PortId"	Porta del listener per le connessioni in ingresso da sharer. Questa proprietà può essere impostata anche sul lato visualizzatore, ma verrà usata solo per l'ascolto delle connessioni in caso di connessione inversa.	VT_I4
"PortProtocol"	Specifica la famiglia di protocolli per avviare il listener in sharer. I valori possibili sono i seguenti: AF_UNSPEC Valore: 0 La famiglia di indirizzi non è specificata. AF_INET Valore: 2 Famiglia di indirizzi Internet Protocol versione 4 (IPv4). AF_INET6 Valore: 23 Famiglia di indirizzi IPv6 (Internet Protocol 6).	VT_I4
"SetNetworkStream"	Puntatore a un'interfaccia IUnknown che supporta l'interfaccia IRDPSRAPITransportStream . Se questa proprietà è impostata, il metodo Connect userà questo flusso e ignorerà il stringa di connessione passato. Questa proprietà è valida solo per il lato visualizzatore.	VT_UNKNOWN
"EnforceStrongEncryption"	Se questa proprietà ha un valore di VARIANT_TRUE, il sharer richiede al visualizzatore di usare la crittografia conforme a Federal Information Processing Standard (FIPS) 140. Il valore predefinito è VARIANT_FALSE. Questa proprietà diventa di sola lettura dopo che viene chiamato il metodo IRDPSRAPISharingSession::Open . È possibile impostare questa proprietà solo prima di chiamare tale metodo. Il supporto del visualizzatore per la conformità FIPS 140 è stato aggiunto in Windows 10 versione 1709. Il sharer rifiuta le connessioni dalle versioni del visualizzatore precedenti a Windows 10 versione 1709. Questa proprietà è valida solo per il lato sharer.	VT_BOOL
"FrameCaptureIntervalInMs"	Specifica l'intervallo di acquisizione del frame. Per impostazione predefinita, l'intervallo di acquisizione frame è di 33 millisecondi, che corrisponde a 30 fotogrammi al secondo. È possibile usare questa proprietà per ottimizzare le prestazioni. Se gli aggiornamenti dello schermo non devono essere eseguiti spesso, l'intervallo di acquisizione può essere aumentato. Ad esempio, un valore di 400 millisecondi genera 2,5 fotogrammi al secondo. Questa proprietà è valida solo per il lato sharer.	VT_I4
"DefaultAttendeeControlLevel"	Specifica il livello di controllo predefinito per i partecipanti. Per impostazione predefinita, questo valore è CTRL_LEVEL_NONE (nessuno). È possibile modificare questo valore in CTRL_LEVEL_VIEW (visualizzazione). Il livello di controllo predefinito non può essere impostato su interattivo. Questa proprietà è valida solo per il lato sharer.	VT_I4
"EnableClipboardRedirect"	Se questa proprietà ha un valore di VARIANT_TRUE, gli Appunti tra sharer e visualizzatore vengono attivati. Il valore predefinito è VARIANT_FALSE. Per usare la condivisione degli Appunti, la sessione deve essere in modalità interattiva. Solo una singola connessione può condividere gli Appunti. La connessione che ha acquisito più di recente il controllo di input assume la condivisione degli Appunti. La condivisione degli Appunti per qualsiasi connessione precedente viene disabilitata automaticamente. Questa proprietà può essere usata solo per le app desktop. Questa proprietà è valida solo per il lato sharer. Questa proprietà è disponibile a partire da Windows 10, versione 1511.	VT_BOOL
"SetClipboardRedirectCallback"	Specifica un puntatore IUnknown a un'istanza di IRDPSRAPIClipboardUseEvents che riceve un callback ogni volta che viene tentata una copia dal computer sharer al visualizzatore. Questa proprietà è rilevante solo se la condivisione degli Appunti è abilitata. Questa proprietà diventa di sola lettura dopo che viene chiamato il metodo IRDPSRAPISharingSession::Open . È possibile impostare questa proprietà solo prima di chiamare tale metodo. Questa proprietà può essere usata solo per le app desktop. Questa proprietà è valida solo per il lato sharer. Questa proprietà è disponibile a partire da Windows 10, versione 1511.	VT_UNKNOWN
"EnabledTransports"	Specifica i trasporti da abilitare. Il valore 3 supporta sia TCP che UDP. Il valore predefinito è 1, ovvero solo TCP. Questa proprietà diventa di sola lettura dopo la chiamata del metodo IRDPSRAPISharingSession::Open . È possibile impostare questa proprietà solo prima di chiamare tale metodo. Questa proprietà è disponibile a partire da Windows 10 versione 1803. Questa proprietà è valida solo per il lato condivisore.	VT_I4

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	rdpencomapi.h
DLL	RdpEncom.dll

Vedi anche

IRDPSRAPISessionProperties

Condividi tramite