Compartilhar via


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

Define ou obtém uma propriedade de sessão nomeada.

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_Property(
  BSTR    PropertyName,
  VARIANT newVal
);

Parâmetros

PropertyName

newVal

Valor retornado

Nenhum

Comentários

Você pode definir e obter as propriedades a seguir. Os nomes de propriedade diferenciam maiúsculas de minúsculas.

Nome da propriedade Descrição da propriedade Tipo de valor
"DrvConAttach"
Nota A propriedade DrvConAttach não está mais disponível para uso a partir de Windows 10. Não há mais um driver espelho para compartilhamento.
 
Há dois modos para o anexo do driver espelho. O primeiro é o modo de carregamento dinâmico. Nesse modo, o driver de espelho será anexado imediatamente depois que um participante estiver conectado à sessão e tiver controle de exibição. O driver espelho será desanexado automaticamente quando o último participante sair da sessão (ou não houver participantes com controle de exibição).

O segundo modo é o modo de carga estático. Nesse modo, o driver espelho é carregado imediatamente após a sessão ser aberta e não é descarregado até que a sessão seja encerrada.

Observe que, em ambos os modos, o driver pode ser desanexado e anexado novamente como resultado de eventos externos, como alterar a resolução da tela ou compartilhar a profundidade da cor.

Defina essa propriedade como VARIANT_TRUE para o modo de anexo dinâmico e para VARIANT_FALSE para o modo de anexo estático. Observe que você pode definir essa propriedade somente antes de chamar o método IRDPSRAPISharingSession::Open ; essa propriedade se torna somente leitura depois que o método Open é chamado. O padrão é VARIANT_TRUE.

Para cenários 1:1, como a Assistência Remota, você deve usar o modo de carga dinâmica porque pode levar muito tempo entre o momento em que a sessão é aberta e o momento em que um especialista se conectará.

Para cenários de 1:M (várias partes), você deve usar o modo de carga estático porque anexar e desanexar o driver de espelho é bastante perturbador e não deve ser feito, a menos que haja um bom motivo.

VT_BOOL
"PortId" Porta do ouvinte para conexões de entrada do sharer. Essa propriedade também pode ser definida no lado do visualizador, mas será usada apenas para escutar conexões no caso de uma conexão inversa. VT_I4
"PortProtocol" Especifica a família de protocolos para iniciar o ouvinte no sharer. Os valores possíveis são os seguintes:
AF_UNSPEC
Valor: 0

A família de endereços não é especificada.

AF_INET
Valor: 2

A família de endereços IPv4 (Protocolo de Internet versão 4).

AF_INET6
Valor: 23

A família de endereços IPv6 (Internet Protocol versão 6).

VT_I4
"SetNetworkStream" Um ponteiro para uma interface IUnknown que dá suporte à interface IRDPSRAPITransportStream . Se essa propriedade for definida, o método Connect usará esse fluxo e ignorará o cadeia de conexão passado.

Essa propriedade é válida somente para o lado do visualizador.

VT_UNKNOWN
"EnforceStrongEncryption" Se essa propriedade tiver um valor de VARIANT_TRUE, o participante do compartilhamento exigirá que o visualizador use a criptografia compatível com o PADRÃO FIPS (Federal Information Processing Standard) 140. O padrão é VARIANT_FALSE.

Essa propriedade se torna somente leitura depois que o método IRDPSRAPISharingSession::Open é chamado. Você pode definir essa propriedade somente antes de chamar esse método.

O suporte do Visualizador para conformidade com FIPS 140 foi adicionado no Windows 10 versão 1709. O participante do compartilhamento rejeita conexões de versões anteriores ao Windows 10, versão 1709.

Essa propriedade é válida somente para o lado do participante do compartilhamento.

VT_BOOL
"FrameCaptureIntervalInMs" Especifica o intervalo de captura de quadros. Por padrão, o intervalo de captura de quadros é de 33 milissegundos, o que corresponde a 30 quadros por segundo.

Você pode usar essa propriedade para otimizar o desempenho. Se as atualizações de tela não precisarem ser feitas com tanta frequência, o intervalo de captura poderá ser aumentado. Por exemplo, um valor de 400 milissegundos resulta em 2,5 quadros por segundo.

Essa propriedade é válida somente para o lado do participante do compartilhamento.

VT_I4
"DefaultAttendeeControlLevel" Especifica o nível de controle padrão para os participantes. Por padrão, esse valor é CTRL_LEVEL_NONE (nenhum). Você pode alterar esse valor para CTRL_LEVEL_VIEW (exibição).

O nível de controle padrão não pode ser definido como interativo.

Essa propriedade é válida somente para o lado do participante do compartilhamento.

VT_I4
"EnableClipboardRedirect" Se essa propriedade tiver um valor de VARIANT_TRUE, a área de transferência entre o participante do compartilhamento e o visualizador será ativada. O padrão é VARIANT_FALSE.

Para usar o compartilhamento da área de transferência, a sessão deve estar no modo interativo.

Somente uma única conexão pode compartilhar a área de transferência. A conexão que mais recentemente adquiriu o controle de entrada assume o compartilhamento da área de transferência. O compartilhamento da área de transferência para qualquer conexão anterior é desabilitado automaticamente.

Essa propriedade só pode ser usada para aplicativos da área de trabalho.

Essa propriedade é válida somente para o lado do participante do compartilhamento.

Essa propriedade está disponível a partir do Windows 10, versão 1511.

VT_BOOL
"SetClipboardRedirectCallback" Especifica um ponteiro IUnknown para uma instância de IRDPSRAPIClipboardUseEvents que recebe um retorno de chamada sempre que uma cópia do computador compartilhador para o visualizador é tentada. Essa propriedade só será relevante se o compartilhamento da área de transferência estiver habilitado.

Essa propriedade se torna somente leitura depois que o método IRDPSRAPISharingSession::Open é chamado. Você pode definir essa propriedade somente antes de chamar esse método.

Essa propriedade só pode ser usada para aplicativos da área de trabalho.

Essa propriedade é válida somente para o lado do participante do compartilhamento.

Essa propriedade está disponível a partir do Windows 10, versão 1511.

VT_UNKNOWN
"EnabledTransports" Especifica os transportes a serem habilitados. Um valor 3 dá suporte a TCP e UDP. O padrão é 1, que é somente TCP.

Essa propriedade se torna somente leitura depois que o método IRDPSRAPISharingSession::Open é chamado. Você só pode definir essa propriedade antes de chamar esse método.

Essa propriedade está disponível a partir do Windows 10, versão 1803.

Essa propriedade é válida apenas para o lado do sharer.

VT_I4

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho rdpencomapi.h
DLL RdpEncom.dll

Confira também

IRDPSRAPISessionProperties