Compartir a través de

Método IRDPSRAPIViewer::Connect (rdpencomapi.h)

  • Artículo

[La interfaz IRDPSRAPIViewer ya no está disponible para su uso en aplicaciones para UWP a partir de Windows 10, versión 1709. Todavía se admite para aplicaciones de escritorio.]

Inicia la conexión real con el compartidor.

Sintaxis

HRESULT Connect(
  [in] BSTR bstrConnectionString,
  [in] BSTR bstrName,
  [in] BSTR bstrPassword
);

Parámetros

[in] bstrConnectionString

Tipo: BSTR

El cadena de conexión que se usa para conectarse al compartidor y autenticar el visor.

[in] bstrName

Tipo: BSTR

Nombre del visor. El nombre se envía al compartidor y a otros visores. La cadena está limitada a 255 caracteres.

[in] bstrPassword

Tipo: BSTR

Contraseña usada para la autenticación. La contraseña se envía fuera de banda desde el compartidor.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto se S_OK. De lo contrario, el valor devuelto es un código de error.

Comentarios

El recurso compartido genera el cadena de conexión contenido en el parámetro bstrConnectionString y lo obtiene el visor completando los pasos siguientes:

  1. El recurso compartido obtiene una instancia de la interfaz IRDPSRAPIInvitationManager de la propiedad IRDPSRAPISharingSession::Invitations .
  2. El recurso compartido obtiene una instancia de la interfaz IRDPSRAPIInvitation llamando al método IRDPSRAPIInvitationManager::CreateInvitation .
  3. El recurso compartido obtiene el cadena de conexión de la propiedad IRDPSRAPIInvitation::ConnectionString.
  4. El compartidor envía el cadena de conexión al visor en un método definido por la aplicación, como almacenar el cadena de conexión en un archivo y compartirlo con el visor.
Para aumentar la seguridad, las aplicaciones pueden asociar contraseñas con una invitación en el lado del compartidor. Normalmente, estas contraseñas se distribuyen a los espectadores a través de algún mecanismo distinto del que se usa para enviar el cadena de conexión. Esto es para evitar los tipos de ataques de "detección" de red. Si una invitación tiene asociada una contraseña, la contraseña debe pasarse a través de esta API. De lo contrario, el asistente se desconectará.

La cadena bstrName establecida en esta propiedad se envía al compartidor después de iniciar la conexión. La propiedad es un nombre descriptivo que la aplicación de sharer puede elegir mostrar. La propiedad es útil cuando se usa una invitación para autenticar a varios asistentes, ya que permite al compartidor y a los demás visores identificar quién participa en una sesión de uso compartido de escritorio de Windows.

Requisitos

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

Consulte también

IRDPSRAPIViewer