IWMDMDevice3::SetProperty-Methode (mswmdm.h)

Artikel
03/06/2024

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.