Metodo IConnector::GetConnectorIdConnectedTo (devicetopology.h)

  • Articolo

Il metodo GetConnectorIdConnectedTo ottiene l'ID globale del connettore, se presente, a cui è connesso questo connettore.

Sintassi

HRESULT GetConnectorIdConnectedTo(
  [out] LPWSTR *ppwstrConnectorId
);

Parametri

[out] ppwstrConnectorId

Puntatore a un puntatore di stringa in cui il metodo scrive l'indirizzo di una stringa con terminazione null, wide-character contenente l'ID globale dell'altro connettore. Il metodo alloca l'archiviazione per la stringa. Il chiamante è responsabile della liberazione dell'archiviazione, quando non è più necessario, chiamando la funzione CoTaskMemFree . Se la chiamata GetConnectorIdConnectedTo ha esito negativo, *ppwstrConnectorId è NULL. Per informazioni su CoTaskMemFree, vedere la documentazione di Windows SDK.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Codice restituito Descrizione
E_NOTFOUND
 Questo connettore non è connesso o l'altro lato della connessione non è un'altra topologia del dispositivo, ad esempio una connessione Software_IO.
E_POINTER
 Il parametro ppwstrConnectorId è NULL.
E_OUTOFMEMORY
 Memoria insufficiente.

Commenti

Un ID globale è una stringa che identifica in modo univoco una parte tra tutte le parti in tutte le topologie del dispositivo nel sistema. I client devono trattare questa stringa come opaca. Ovvero, i client non devono tentare di analizzare il contenuto della stringa per ottenere informazioni sulla parte. Il motivo è che il formato stringa non è definito e potrebbe cambiare da un'implementazione dell'API DeviceTopology al successivo.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione devicetopology.h

Vedi anche

Interfaccia IConnector