IMDSPDevice2::GetCanonicalName-Methode (mswmdm.h)
Die GetCanonicalPName-Methode ruft den kanonischen Namen eines Geräts ab.
Syntax
HRESULT GetCanonicalName(
[out] LPWSTR pwszPnPName,
[in] UINT nMaxChars
);
Parameter
[out] pwszPnPName
Ein puffer mit breitem Zeichen und NULL-Terminen, der den kanonischen Namen enthält. Der Aufrufer weist diesen Puffer zu und gibt ihn frei.
[in] nMaxChars
Ganze Zahl, die die maximale Anzahl von Zeichen enthält, die in pwszCanonicalName platziert werden können, einschließlich des Beendigungszeichens.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
Hinweise
Diese Methode gibt einen kanonischen Namen für das Gerät zurück. Der Dienstanbieter sollte den Gerätepfadnamen des Geräts als kanonischen Namen zurückgeben. Dem Dienstanbieter wird der Gerätepfadname in der CreateDevice-Methode auf der IMDServiceProvider2-Schnittstelle übergeben.
Diese Eingabe ist optional. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |