IMDSPDevice3::GetProperty-Methode (mswmdm.h)

Artikel
08/25/2023

Die GetProperty-Methode ruft eine bestimmte Geräteeigenschaft ab.

Syntax

HRESULT GetProperty(
  [in]  LPCWSTR     pwszPropName,
  [out] PROPVARIANT *pValue
);

Parameter

[in] pwszPropName

Name der Eigenschaft, die vom Gerät abgerufen wird.

[out] pValue

Zurückgegebener Wert für die Eigenschaft.

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

Die Variante, auf die pValue verweist, wird auf eine leere PROPVARIANT-Eigenschaft festgelegt, d. h. ihre VT ist auf VT_EMPTY festgelegt.

Der Dienstanbieter sollte diese Variante auf den entsprechenden Eigenschaftswert für die Eigenschaft pwszPropName festlegen.

Wenn pwszPropNameg_wszWMDMSupportedDeviceProperties ist, sollte der Dienstanbieter ein Array der unterstützten Geräteeigenschaften zurückgeben. In diesem Fall sollte die VT der Variante VT_BSTR | VT_ARRAY.

Eine Liste der Standardgeräteeigenschaftennamen finden Sie unter Metadatenkonstanten.

Diese Methode ähnelt den Methoden IMDSPStorage3::GetMetadata und IMDSPStorage4::GetSpecifiedMetadata für Speicher, aber diese Methode kann jeweils nur eine Eigenschaft abrufen.