IMDSPDevice3::GetProperty-Methode (mswmdm.h)

Artikel
03/05/2025

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

Syntax

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

Parameter

[in] pwszPropName

Der 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 Device Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

Standard-COM-Fehlercodes
Windows-Fehlercodes, die in HRESULT-Werte konvertiert wurden
Windows Media Device Manager –Fehlercodes

Eine umfangreiche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Bemerkungen

Die Variante, auf die pValue verweist, wird auf ein leeres PROPVARIANT-festgelegt, d. h. dessen VT wird auf VT_EMPTY festgelegt.

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

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

Eine Liste der Standardmäßigen Geräteeigenschaftennamen finden Sie unter Metadatenkonstanten.

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