IFunctionDiscoveryProvider::InstancePropertyStoreOpen method (functiondiscoveryprovider.h)

Article
02/22/2024

[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.

Syntax

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

Parameters

[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:

STGM_READ

STGM_READWRITE

STGM_WRITE

[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
S_OK	The method completed successfully.
E_NOTIMPL	The provider does not implement an instance property store.
STG_E_ACCESSDENIED	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.
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.

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

Share via