IWbemPropertyProvider::GetProperty method

The IWbemPropertyProvider::GetProperty method is called by Windows Management to retrieve an individual property value.

Syntax

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

Parameters

lFlags

Reserved. This parameter must be 0.

strLocale

String indicating the desired locale in cases where the returned property value can be localized. If the property cannot be localized, the implementation can ignore this value.

strClassMapping

Literal copy of the string value for the ClassContext qualifier for the class. This points to a valid BSTR, which is treated as read-only, or NULL if the qualifier does not exist.

strInstMapping

Literal copy of the string value for the InstanceContext qualifier for the instance. This must point to a valid BSTR, which is treated as read-only, or NULL if the qualifier does not exist.

strPropMapping

Literal copy of the value of the PropertyContext qualifier for the property. This must point to a valid BSTR, which is treated as read-only, or NULL if the qualifier does not exist.

pvValue

Pointer to an uninitialized VARIANT that receives the value for the property. The implementation must call VariantInit and return the value. If an error occurs, the implementation is expected to ignore the pointer.

Return value

This method must return WBEM_S_NO_ERROR if the call succeeds. If the call fails, the method must return WBEM_S_FALSE.

Requirements

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header wbemprov.h (include Wbemidl.h)
Library Wbemuuid.lib
DLL Wbemsvc.dll

See also

Constructing Property Providers

IWbemPropertyProvider

PutProperty