Поделиться через

Метод IRDPSRAPIViewer::Connect (rdpencomapi.h)

  • Статья

[Интерфейс IRDPSRAPIViewer больше недоступен для использования в приложениях UWP с Windows 10 версии 1709. Он по-прежнему поддерживается для классических приложений.]

Запускает фактическое подключение к объекту общего доступа.

Синтаксис

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

Параметры

[in] bstrConnectionString

Тип: BSTR

Строка подключения используется для подключения к средству общего доступа и проверки подлинности средства просмотра.

[in] bstrName

Тип: BSTR

Имя средства просмотра. Имя отправляется в общий доступ и другим зрителям. Длина строки ограничена 255 символами.

[in] bstrPassword

Тип: BSTR

Пароль, используемый для проверки подлинности. Пароль отправляется из общего доступа.

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае возвращаемое значение является кодом ошибки.

Комментарии

Строка подключения, содержащийся в параметре bstrConnectionString, создается средством общего доступа и получается средством просмотра, выполнив следующие действия:

  1. Средство общего доступа получает экземпляр интерфейса IRDPSRAPIInvitationManager из свойства IRDPSRAPISharingSession::Invitations .
  2. Средство общего доступа получает экземпляр интерфейса IRDPSRAPIInvitation, вызывая метод IRDPSRAPIInvitationManager::CreateInvitation .
  3. Общий доступ получает строка подключения из свойства IRDPSRAPIInvitation::ConnectionString.
  4. Средство общего доступа отправляет строка подключения средству просмотра в определяемом приложением методе, например сохраняет строка подключения в файле и предоставляет общий доступ к файлу средству просмотра.
Для повышения безопасности приложения могут связывать пароли с приглашением на стороне общего доступа. Такие пароли обычно распространяются среди зрителей с помощью механизма, отличного от того, который используется для отправки строка подключения. Это необходимо для предотвращения сетевых "sniffing" типов атак. Если с приглашением связан пароль, пароль должен передаваться через этот API. В противном случае участник будет отключен.

Строка bstrName , заданная в этом свойстве, отправляется в общий доступ после запуска подключения. Свойство — это понятное имя, которое может отобразить приложение общего доступа. Свойство полезно, когда приглашение используется для проверки подлинности нескольких участников, так как оно позволяет общему пользователю и другим зрителям определить, кто участвует в сеансе общего доступа к рабочему столу Windows.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header rdpencomapi.h
DLL RdpEncom.dll

См. также раздел

IRDPSRAPIViewer