IMDSPDevice2::GetCanonicalName-Methode (mswmdm.h)

Artikel
03/04/2024

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.