Metodo IWMDeviceManager2::GetDeviceFromCanonicalName (mswmdm.h)
Il metodo GetDeviceFromCanonicalName recupera un'interfaccia IWMDMDevice per un dispositivo con un nome canonico specificato. È possibile recuperare il nome canonico di un dispositivo chiamando IWMDMDevice2::GetCanonicalName.
Sintassi
HRESULT GetDeviceFromCanonicalName(
LPCWSTR pwszCanonicalName,
IWMDMDevice **ppDevice
);
Parametri
pwszCanonicalName
Stringa con terminazione Null a caratteri wide che specifica il nome canonico del dispositivo.
ppDevice
Puntatore a un puntatore all'interfaccia IWMDMDevice dell'oggetto dispositivo con il nome canonico specificato. Il chiamante deve rilasciare questa interfaccia al termine dell'operazione.
Valore restituito
Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il parametro pwszCanonicalName o ppDeviceArray è un puntatore NULL o non valido. |
|
Non è stato trovato alcun dispositivo connesso con il nome canonico pwszCanonicalName. |
Commenti
Questo metodo può essere utile se un'applicazione implementa IWMDMNotification, che invia una notifica di nome canonico quando un dispositivo si connette o si disconnette dal computer.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |