IWMDeviceManager2::GetDeviceFromCanonicalName-Methode (mswmdm.h)
Die GetDeviceFromCanonicalName-Methode ruft eine IWMDMDevice-Schnittstelle für ein Gerät mit einem angegebenen kanonischen Namen ab. Sie können den kanonischen Namen eines Geräts abrufen, indem Sie IWMDMDevice2::GetCanonicalName aufrufen.
Syntax
HRESULT GetDeviceFromCanonicalName(
LPCWSTR pwszCanonicalName,
IWMDMDevice **ppDevice
);
Parameter
pwszCanonicalName
Eine Breitzeichenzeichenfolge mit NULL-Beendigung, die den kanonischen Namen des Geräts angibt.
ppDevice
Zeiger auf einen Zeiger auf die IWMDMDevice-Schnittstelle des Geräteobjekts mit dem angegebenen kanonischen Namen. Der Aufrufer muss diese Schnittstelle freigeben, wenn er damit fertig ist.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | Beschreibung |
|---|---|
|
Der pwszCanonicalName- oder ppDeviceArray-Parameter ist ein ungültiger oder NULL-Zeiger . |
|
Es wurde kein verbundenes Gerät mit dem kanonischen Namen pwszCanonicalName gefunden. |
Hinweise
Diese Methode kann nützlich sein, wenn eine Anwendung IWMDMNotification implementiert, die eine kanonische Namensbenachrichtigung sendet, wenn ein Gerät eine Verbindung mit dem Computer herstellt oder die Verbindung vom Computer trennt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |