共用方式為


iWMDMDevice3::SetProperty 方法 (mswmdm.h)

如果 SetProperty 方法可寫入,則會設定特定的裝置屬性。

語法

HRESULT SetProperty(
  [in] LPCWSTR           pwszPropName,
  [in] const PROPVARIANT *pValue
);

參數

[in] pwszPropName

要設定之屬性的寬字元、以 Null 結束的字串名稱。 這會覆寫任何具有相同名稱的現有屬性。 應用程式進行此呼叫之後,它應該會使用 PropVariantClear 釋放任何動態記憶體。 元數據常數中會提供標準屬性名稱常數的清單。

[in] pValue

正在設定之屬性的值。

傳回值

方法會傳回 HRESULT。 Windows Media 中的所有介面方法 裝置管理員 都可以傳回下列任何錯誤碼類別:

  • 標準 COM 錯誤碼
  • 轉換成 HRESULT 值的 Windows 錯誤碼
  • Windows Media 裝置管理員 錯誤碼
如需可能錯誤碼的廣泛清單,請參閱 錯誤碼

備註

這個方法會設定指定的裝置屬性。 若要取得支援的裝置屬性清單,客戶端應該查詢 g_wszWMDMSupportedDeviceProperties 屬性的IWMDMDevice3::GetProperty 方法。

如需裝置屬性名稱的清單,請參閱 元數據常數

這個方法類似於記憶體的 SetMetadata 方法,但這個方法一次只能設定一個屬性。

並非所有裝置的屬性都可以設定。

規格需求

需求
目標平台 Windows
標頭 mswmdm.h
程式庫 Mssachlp.lib

另請參閱

列舉裝置

IWMDMDevice3 介面

IWMDMDevice3::GetProperty

IWMDMStorage3::SetMetadata

IWMDMStorage4::GetSpecifiedMetadata

在檔案上設定元數據