IFunctionDiscoveryProvider::InstancePropertyStoreOpen method (functiondiscoveryprovider.h)

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

Opens the property store of the provider. This method is called whenever IFunctionInstance::OpenPropertyStore is called if the provider did not provide a property store at creation time. The provider can provide the property store at this time, or handle the IProviderProperties methods as they are called.


HRESULT InstancePropertyStoreOpen(
  [in]  IFunctionInstance *pIFunctionInstance,
  [in]  INT_PTR           iProviderInstanceContext,
  [in]  const DWORD       dwStgAccess,
  [out] IPropertyStore    **ppIPropertyStore


[in] pIFunctionInstance

A pointer to the IFunctionInstance interface for the store that is to be opened. Each property store is associated with a function instance.

[in] iProviderInstanceContext

The context associated with the specific function instance.

[in] dwStgAccess

The access mode to be assigned to the open stream. For this method, the following modes are supported:




[out] ppIPropertyStore

A pointer to an IPropertyStore interface pointer.

Return value

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

Return code Description
The method completed successfully.
The provider does not implement an instance property store.
The method could not open a writable property store because the caller has insufficient access, the discovery provider does not allow write access to its property store, or another property store is already open for this function instance.
One of the parameters contains an invalid argument.
The method is unable to allocate the memory required to perform this operation.


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