Metodo IConnectionBrokerClient::GetTargetInfo
Richiede informazioni sul computer di destinazione in cui deve essere reindirizzata la connessione. Questo metodo viene usato dal reindirizzamento per ottenere informazioni di reindirizzamento per la richiesta di connessione in ingresso.
Sintassi
HRESULT GetTargetInfo(
[in] CB_CONNECTION_INFO *pConnectionInfo,
[in] DWORD Reserved,
[in] HANDLE hStatusEvent,
[out] CB_TARGET_INFO *pTargetInfo,
[out] DWORD *pResult,
[out] IConnectionBrokerRequest **ppCbReq
);
Parametri
-
pConnectionInfo [in]
-
Indirizzo di una struttura CB_CONNECTION_INFO contenente informazioni sulla richiesta di connessione in ingresso.
-
Riservato [in]
-
Questo parametro è riservato per l'uso futuro e deve essere zero.
-
hStatusEvent [in]
-
Handle di un evento che verrà impostato ogni volta che è presente un aggiornamento allo stato di avanzamento della richiesta. Si è responsabili della creazione e della chiusura di questo evento.
-
pTargetInfo [out]
-
Indirizzo di una struttura CB_TARGET_INFO che riceve informazioni sul computer di destinazione in cui deve essere reindirizzata la connessione in ingresso. Poiché si tratta di un metodo asincrono, questa memoria deve rimanere disponibile fino al completamento della richiesta. Per altre informazioni, vedere la sezione Osservazioni.
-
pResult [out]
-
Indirizzo di una variabile DWORD che riceve un codice di risultato. Poiché si tratta di un metodo asincrono, questa memoria deve rimanere disponibile fino al completamento della richiesta. Per altre informazioni, vedere la sezione Osservazioni.
Questo codice di risultato sarà uno dei valori seguenti.
-
0
-
Esito positivo.
-
0x0000400
-
Impossibile trovare il computer di destinazione.
-
0x0000401
-
Il computer di destinazione non è disponibile.
-
0x0000402
-
Errore durante il caricamento del computer di destinazione.
-
0x0000403
-
Errore che porta online il computer di destinazione.
-
0x0000404
-
Errore di reindirizzamento al computer di destinazione.
-
0x0000405
-
Errore di riattivazione della macchina virtuale.
-
0x0000406
-
Errore durante l'avvio della macchina virtuale.
-
0x0000407
-
Errore durante la ricerca dell'indirizzo IP della macchina virtuale.
-
0x0000408
-
Il broker di sessioni non è riuscito a trovare computer disponibili nel pool.
-
0x0000409
-
Il broker di sessione ha annullato la connessione.
-
0x0000410
-
Impossibile convalidare le impostazioni di connessione del broker di sessione.
ppCbReq [out]
Indirizzo di un puntatore dell'interfaccia IConnectionBrokerRequest usato per ottenere gli aggiornamenti dello stato per un'operazione asincrona. Questa interfaccia viene usata insieme al parametro hStatusEvent per attendere e ottenere i risultati di questa operazione asincrona.
Valore restituito
Restituisce E_PENDING se viene creata la richiesta asincrona. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Questo metodo è asincrono. I parametri pTargetInfo e pResult devono rimanere validi finché il metodo IConnectionBrokerRequest::CheckStatus ottiene CB_STATUS_REQUEST_COMPLETED.
Per altre informazioni su come usare questo metodo, vedere Come usare l'API client di Gestione connessione Desktop remoto.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 8 |
| Server minimo supportato |
Windows Server 2012 |
| Intestazione |
|
| Libreria |
|
| DLL |
|