Condividi tramite

Metodo IRDPSRAPIViewer::Connect (rdpencomapi.h)

  • Articolo

[L'interfaccia IRDPSRAPIViewer non è più disponibile per l'uso per le applicazioni UWP a partire da Windows 10 versione 1709. È ancora supportato per le app desktop.

Avvia la connessione effettiva al condivisore.

Sintassi

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

Parametri

[in] bstrConnectionString

Tipo: BSTR

Il stringa di connessione utilizzato per connettersi al condivisore e autenticare il visualizzatore.

[in] bstrName

Tipo: BSTR

Nome del visualizzatore. Il nome viene inviato al condivisore e ad altri visualizzatori. La stringa è limitata a 255 caratteri.

[in] bstrPassword

Tipo: BSTR

Password usata per l'autenticazione. La password viene inviata fuori banda dal condivisore.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene S_OK. In caso contrario, il valore restituito è un codice di errore.

Commenti

Il stringa di connessione contenuto nel parametro bstrConnectionString viene generato dal condivisore e ottenuto dal visualizzatore completando i passaggi seguenti:

  1. Il condivisore ottiene un'istanza dell'interfaccia IRDPSRAPIInvitationManager dalla proprietà IRDPSRAPISharingSession::Invitations .
  2. Il condivisore ottiene un'istanza dell'interfaccia IRDPSRAPIInvitation chiamando il metodo IRDPSRAPIInvitationManager::CreateInvitation .
  3. Il condivisore ottiene il stringa di connessione dalla proprietà IRDPSRAPIInvitation::ConnectionString.
  4. Il condivisore invia il stringa di connessione al visualizzatore in un metodo definito dall'applicazione, ad esempio l'archiviazione del stringa di connessione in un file e la condivisione del file con il visualizzatore.
Per una maggiore sicurezza, le applicazioni possono associare le password a un invito sul lato condivisore. Tali password vengono in genere distribuite ai visualizzatori tramite un meccanismo diverso da quello usato per inviare il stringa di connessione. Ciò consente di evitare tipi di attacchi di tipo "sniffing" di rete. Se a un invito è associata una password, la password deve essere passata tramite questa API. In caso contrario, il partecipante verrà disconnesso.

La stringa bstrName impostata in questa proprietà viene inviata al condivisore dopo l'avvio della connessione. La proprietà è un nome descrittivo che l'applicazione di condivisione può scegliere di visualizzare. La proprietà è utile quando un invito viene usato per autenticare più partecipanti perché consente al condivisore e agli altri visualizzatori di identificare chi partecipa a una sessione di Condivisione desktop di Windows.

Requisiti

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

Vedi anche

IRDPSRAPIViewer