Edit

Share via

IFunctionDiscoveryProvider::InstancePropertyStoreFlush method (functiondiscoveryprovider.h)

  • Article

[Function Discovery is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Provides a mechanism for the provider to persist properties without having to implement IProviderProperties. This method is called whenever IPropertyStore::Commit is called by the client on the function instance property store.

Syntax

HRESULT InstancePropertyStoreFlush(
  [in] IFunctionInstance *pIFunctionInstance,
  [in] INT_PTR           iProviderInstanceContext
);

Parameters

[in] pIFunctionInstance

A pointer to the IFunctionInstance interface.

[in] iProviderInstanceContext

The context associated with the specific function instance.

Return value

This method can return one of these values.

Possible return values include, but are not limited to, the following.

Return code Description
S_OK
 The method completed successfully.
E_NOTIMPL
 The provider does not implement an instance property store.
E_INVALIDARG
 One of the parameters contains an invalid argument.
E_OUTOFMEMORY
 The method is unable to allocate the memory required to perform this operation.

Remarks

If the provider keeps the new values that are passed through SetValue cached in memory, this method should implement the code to persist the updated values to the underlying API/store.

If you implement this method, you should call OpenPropertyStore to return the current property store before persisting the data.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header functiondiscoveryprovider.h

See also

IFunctionDiscoveryProvider