IMDSPDevice::GetName 方法 (mswmdm.h)
GetName 方法會擷取裝置的名稱。
語法
HRESULT GetName(
[out] LPWSTR pwszName,
[in] UINT nMaxChars
);
參數
[out] pwszName
接收裝置名稱字串之16位Unicode字元陣列的指標。
[in] nMaxChars
要複製到字串的最大字元數。
傳回值
方法會傳回 HRESULT。 Windows Media 中的所有介面方法 裝置管理員 都可以傳回下列任何錯誤碼類別:
- 標準 COM 錯誤碼
- 轉換成 HRESULT 值的 Windows 錯誤碼
- Windows Media 裝置管理員 錯誤碼
備註
LPWSTR 字串類型是 16 位 Unicode 字元字串,不接受位元元元大小的字元。 若要將位元組大小的字元字串 (LPCSTR) 轉換成 LPWSTR 字串,請使用 Microsoft Windows 檔中所述的 MultiByteToWideChar 函 式。
裝置名稱不得包含尾端空格。
這個方法必須實作。 它不得傳回WMDM_E_NOTSUPPORTED或E_NOTIMPL。 如需詳細資訊,請參閱 強制和選擇性介面。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | mswmdm.h |
程式庫 | Mssachlp.lib |