IConnectionBrokerClient::GetTargetInfo-Methode

Fordert Informationen zum Zielcomputer an, auf dem die Verbindung umgeleitet werden soll. Diese Methode wird vom Redirector verwendet, um Umleitungsinformationen für die eingehende Verbindungsanforderung zu erhalten.

Syntax

HRESULT GetTargetInfo(
  [in]  CB_CONNECTION_INFO       *pConnectionInfo,
  [in]  DWORD                    Reserved,
  [in]  HANDLE                   hStatusEvent,
  [out] CB_TARGET_INFO           *pTargetInfo,
  [out] DWORD                    *pResult,
  [out] IConnectionBrokerRequest **ppCbReq
);

Parameter

pConnectionInfo [ In]

Die Adresse einer CB _ CONNECTION _ INFO-Struktur, die Informationen über die eingehende Verbindungsanforderung enthält.

Reserviert [ In]

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss 0 (null) sein.

hStatusEvent [ In]

Das Handle eines Ereignisses, das festgelegt wird, wenn ein Update des Status der Anforderung vorkommt. Sie sind für das Erstellen und Schließen dieses Ereignisses verantwortlich.

pTargetInfo [ out]

Die Adresse einer CB _ TARGET _ INFO-Struktur, die Informationen über den Zielcomputer empfängt, auf dem die eingehende Verbindung umgeleitet werden soll. Da es sich um eine asynchrone Methode handelt, muss dieser Arbeitsspeicher verfügbar bleiben, bis die Anforderung abgeschlossen ist. Weitere Informationen finden Sie in den Hinweisen.

pResult [ out]

Die Adresse einer DWORD-Variablen, die einen Ergebniscode empfängt. Da es sich um eine asynchrone Methode handelt, muss dieser Arbeitsspeicher verfügbar bleiben, bis die Anforderung abgeschlossen ist. Weitere Informationen finden Sie in den Hinweisen.

Dieser Ergebniscode ist einer der folgenden Werte.

0

Erfolg.

0x0000400

Der Zielcomputer wurde nicht gefunden.

0x0000401

Der Zielcomputer ist nicht verfügbar.

0x0000402

Fehler beim Laden des Zielcomputers.

0x0000403

Fehler beim Online stellen des Zielcomputers.

0x0000404

Fehler beim Umleiten zum Zielcomputer.

0x0000405

Fehler beim Waking des virtuellen Computers.

0x0000406

Fehler beim Starten des virtuellen Computers.

0x0000407

Fehler beim Suchen der IP-Adresse des virtuellen Computers.

0x0000408

Der Sitzungsbroker konnte keine verfügbaren Computer im Pool finden.

0x0000409

Der Sitzungsbroker hat die Verbindung abgebrochen.

0x0000410

Der Sitzungsbroker konnte die Verbindungseinstellungen nicht überprüfen.

ppCbReq [ out]

Die Adresse eines IConnectionBrokerRequest-Schnittstellenzeigers, den Sie verwenden, um Statusupdates für einen asynchronen Vorgang zu erhalten. Diese Schnittstelle wird in Verbindung mit dem hStatusEvent-Parameter verwendet, um auf die Ergebnisse dieses asynchronen Vorgangs zu warten und diese zu erhalten.

Rückgabewert

Gibt E _ PENDING zurück, wenn die asynchrone Anforderung erstellt wird. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Diese Methode ist asynchron. Die Parameter pTargetInfo und pResult müssen gültig bleiben, bis die IConnectionBrokerRequest::CheckStatus-Methode CB STATUS REQUEST COMPLETED _ _ _ erhält.

Weitere Informationen zur Verwendung dieser Methode finden Sie unter Verwenden der Remotedesktopverbindung Broker-Client-API.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 8
Unterstützte Mindestversion (Server)
Windows Server 2012
Header
Cbclient.h
Bibliothek
Cbclient.lib
DLL
Cbclient.dll

Siehe auch

IConnectionBrokerClient