Edit

IFunctionDiscoveryProvider::InstancePropertyStoreOpen 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.]

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

See also

IFunctionDiscoveryProvider