Metodo IConnector::GetConnectedTo (devicetopology.h)
Il metodo GetConnectedTo ottiene il connettore a cui è connesso questo connettore.
Sintassi
HRESULT GetConnectedTo(
[out] IConnector **ppConTo
);
Parametri
[out] ppConTo
Puntatore a una variabile del puntatore in cui il metodo scrive l'indirizzo dell'interfaccia IConnector dell'altro oggetto connettore. Tramite questo metodo, il chiamante ottiene un riferimento conteggiato all'interfaccia. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata GetConnectedTo ha esito negativo, *ppConTo è NULL.
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Puntatore ppConTo è NULL. |
|
Questo connettore non è connesso o l'altro lato della connessione non è un'altra topologia del dispositivo, ad esempio una connessione Software_IO. |
|
La topologia del dispositivo dall'altra parte della connessione non è attiva, ovvero lo stato del dispositivo non è DEVICE_STATE_ACTIVE. |
Commenti
Per esempi di codice che chiamano questo metodo, vedere le implementazioni delle funzioni GetHardwareDeviceTopology e SelectCaptureDevice in Topologie di dispositivo.
Per informazioni sulle connessioni Software_IO, vedere Enumerazione ConnectorType. Per informazioni sulla macro HRESULT_FROM_WIN32, vedere la documentazione di Windows SDK. Per informazioni sullo stato del dispositivo DEVICE_STATE_NOTPRESENT, vedere costanti DEVICE_STATE_XXX.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | devicetopology.h |