IWMDMDevice3::SetProperty-Methode (mswmdm.h)

Die SetProperty-Methode legt eine bestimmte Geräteeigenschaft fest, wenn sie beschreibbar ist.

Syntax

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

Parameter

[in] pwszPropName

Ein Breitzeichen, nullbeendigter Zeichenfolgenname der festzulegenden Eigenschaft. Dadurch werden alle vorhandenen Eigenschaften mit demselben Namen überschrieben. Nachdem die Anwendung diesen Aufruf durchgeführt hat, sollte sie mithilfe von PropVariantClear jeden dynamischen Arbeitsspeicher freigeben. Eine Liste der Standardeigenschaftennamenkonstanten wird unter Metadatenkonstanten angegeben.

[in] pValue

Wert der eigenschaft, die festgelegt wird.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

  • Standard-COM-Fehlercodes
  • In HRESULT-Werte konvertierte Windows-Fehlercodes
  • Windows Media Geräte-Manager Fehlercodes
Eine umfassende Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Diese Methode legt die angegebene Geräteeigenschaft fest. Um die Liste der unterstützten Geräteeigenschaften abzurufen, sollte der Client die IWMDMDevice3::GetProperty-Methode für die g_wszWMDMSupportedDeviceProperties-Eigenschaft abfragen.

Eine Liste der Geräteeigenschaftennamen finden Sie unter Metadatenkonstanten.

Diese Methode ähnelt der SetMetadata-Methode für Speicher, aber diese Methode kann nur eine Eigenschaft gleichzeitig festlegen.

Nicht alle Eigenschaften des Geräts können festgelegt werden.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

Auflisten von Geräten

IWMDMDevice3-Schnittstelle

IWMDMDevice3::GetProperty

IWMDMStorage3::SetMetadata

IWMDMStorage4::GetSpecifiedMetadata

Festlegen von Metadaten für eine Datei