IMDSPDevice2：：GetCanonicalName 方法 (mswmdm.h)

GetCanonicalPName 方法會取得裝置的正式名稱。

語法

HRESULT GetCanonicalName(
  [out] LPWSTR pwszPnPName,
  [in]  UINT   nMaxChars
);

[out] pwszPnPName

保存標準名稱的寬字元、以 Null 結尾的緩衝區。呼叫端會配置並釋放這個緩衝區。

[in] nMaxChars

整數，包含可放置在 pwszCanonicalName 中的字元數上限，包括終止字元。

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

這個方法會傳回裝置的正式名稱。服務提供者應該傳回裝置的裝置路徑名稱作為其標準名稱。服務提供者會在 IMDServiceProvider2 介面的 CreateDevice 方法中傳遞裝置路徑名稱。

這是選擇性的。如需詳細資訊，請參閱強制和選擇性介面。