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 |
|
| Bibliothek |
|
| DLL |
|