IWbemPropertyProvider::PutProperty

[This is preliminary documentation and subject to change.]

The IWbemPropertyProvider::PutProperty method is implemented by a dynamic property provider. It is called by CIMOM whenever a dynamic property value is written. The guidelines below show the method's behavior in response to CIMOM's call.

HRESULT IWbemPropertyProvider::PutProperty(
  [in] Long lFlags,
  [in] BSTR bstrLocale,
  [in] BSTR bstrClassMapping,
  [in] BSTR bstrInstMapping,
  [in] BSTR bstrPropMapping,
  [in] VARIANT *pvValue
);
 

Parameters

lFlags

Reserved. It must be zero.

bstrLocale

A 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. See Locale Strings.

bstrClassMapping

The class mapping string passed in by CIMOM. This indicates the CIM class for which the property is being requested. It must point to a valid BSTR, which is treated as read-only.

bstrInstMapping

This is a private mapping string that can only be interpreted by the implementation. It is a 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.

bstrPropMapping

The property mapping string passed by CIMOM, which can only be interpreted by the implementation. It is a literal copy of the value of the PROPERTYCONTEXT qualifier for the property. It will point to a valid BSTR, which must be treated as read-only.

pvValue

Points to an existing VARIANT that contains the value to be written.

Return Values

The implementation must return S_OK if the operation succeeds, or S_FALSE if not.

See Also

GetProperty