IWbemPropertyProvider::GetProperty-Methode (wbemprov.h)

Artikel
03/03/2024

Die IWbemPropertyProvider::GetProperty-Methode wird von der Windows-Verwaltung aufgerufen, um einen einzelnen Eigenschaftswert abzurufen.

Syntax

HRESULT GetProperty(
  [in]  long       lFlags,
  [in]  const BSTR strLocale,
  [in]  const BSTR strClassMapping,
  [in]  const BSTR strInstMapping,
  [in]  const BSTR strPropMapping,
  [out] VARIANT    *pvValue
);

Parameter

[in] lFlags

Reserviert. Dieser Parameter muss 0 sein.

[in] strLocale

Zeichenfolge, die das gewünschte Gebietsschema angibt, wenn der zurückgegebene Eigenschaftswert lokalisiert werden kann. Wenn die Eigenschaft nicht lokalisiert werden kann, kann die Implementierung diesen Wert ignorieren.

[in] strClassMapping

Literale Kopie des Zeichenfolgenwerts für den ClassContext-Qualifizierer für die Klasse. Dies verweist auf einen gültigen BSTR, der als schreibgeschützt behandelt wird, oder AUF NULL , wenn der Qualifizierer nicht vorhanden ist.

[in] strInstMapping

Literale Kopie des Zeichenfolgenwerts für den InstanceContext-Qualifizierer für die instance. Dies muss auf einen gültigen BSTR verweisen, der als schreibgeschützt behandelt wird, oder AUF NULL , wenn der Qualifizierer nicht vorhanden ist.

[in] strPropMapping

Literalkopie des Werts des PropertyContext-Qualifizierers für die Eigenschaft. Dies muss auf einen gültigen BSTR verweisen, der als schreibgeschützt behandelt wird, oder AUF NULL , wenn der Qualifizierer nicht vorhanden ist.

[out] pvValue

Zeiger auf einen nicht initialisierten VARIANT-Wert , der den Wert für die -Eigenschaft empfängt. Die Implementierung muss VariantInit aufrufen und den Wert zurückgeben. Wenn ein Fehler auftritt, wird erwartet, dass die Implementierung den Zeiger ignoriert.

Rückgabewert

Diese Methode muss WBEM_S_NO_ERROR zurückgeben, wenn der Aufruf erfolgreich ist. Wenn der Aufruf fehlschlägt, muss die Methode WBEM_S_FALSE zurückgeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemprov.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Wbemsvc.dll

Weitere Informationen

Erstellen von Eigenschaftenanbietern

IWbemPropertyProvider

PutProperty

Freigeben über