IConnectionBrokerClient::GetTargetInfo-Methode
Fordert Informationen zum Zielcomputer an, auf dem die Verbindung umgeleitet werden soll. Diese Methode wird vom Umleitungsor verwendet, um Umleitungsinformationen für die eingehende Verbindungsanforderung abzurufen.
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 null sein.
-
hStatusEvent [in]
-
Das Handle eines Ereignisses, das immer dann festgelegt wird, wenn der Status der Anforderung aktualisiert wird. 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 bis zum Abschluss der Anforderung verfügbar bleiben. 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 bis zum Abschluss der Anforderung verfügbar bleiben. Weitere Informationen finden Sie in den Hinweisen.
Dieser Ergebniscode ist einer der folgenden Werte.
-
0
-
Erfolg.
-
0x0000400
-
Der Zielcomputer konnte nicht gefunden werden.
-
0x0000401
-
Der Zielcomputer ist nicht verfügbar.
-
0x0000402
-
Fehler beim Laden des Zielcomputers.
-
0x0000403
-
Fehler beim Online schalten des Zielcomputers.
-
0x0000404
-
Fehler beim Umleiten zum Zielcomputer.
-
0x0000405
-
Fehler beim Aktivieren des virtuellen Computers.
-
0x0000406
-
Fehler beim Starten des virtuellen Computers.
-
0x0000407
-
Fehler beim Ermitteln 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, mit dem Sie status Updates für einen asynchronen Vorgang abrufen. Diese Schnittstelle wird in Verbindung mit dem hStatusEvent-Parameter verwendet, um auf die Ergebnisse dieses asynchronen Vorgangs zu warten und abzurufen.
Rückgabewert
Gibt E_PENDING zurück, wenn die asynchrone Anforderung erstellt wird. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Bemerkungen
Diese Methode ist asynchron. Die Parameter pTargetInfo und pResult müssen gültig bleiben, bis die IConnectionBrokerRequest::CheckStatus-MethodeCB_STATUS_REQUEST_COMPLETED abruft.
Weitere Informationen zur Verwendung dieser Methode finden Sie unter Verwenden der Client-API des Remotedesktop-Verbindungsbrokers.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 8 |
| Unterstützte Mindestversion (Server) |
Windows Server 2012 |
| Header |
|
| Bibliothek |
|
| DLL |
|