IFunctionDiscoveryProvider::InstancePropertyStoreValidateAccess method (functiondiscoveryprovider.h)

Article
10/13/2021

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

Verifies that the provider supports the requested access. It is called when OpenPropertyStore is called on a function instance to verify that the provider supports the access mode passed by the dwStgAccess parameter.

This method is only called when a provider's Initialize method returns a pdwStgAccessCapabilities parameter value of -1.

Syntax

HRESULT InstancePropertyStoreValidateAccess(
  [in] IFunctionInstance *pIFunctionInstance,
  [in] INT_PTR           iProviderInstanceContext,
  [in] const DWORD       dwStgAccess
);

Parameters

[in] pIFunctionInstance

A pointer to the IFunctionInstance interface.

[in] iProviderInstanceContext

The context associated with the specific function instance.

[in] dwStgAccess

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

STGM_READ

STGM_READWRITE

STGM_WRITE

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	The value of dwStgAccess is invalid.
E_OUTOFMEMORY	The method is unable to allocate the memory required to perform this operation.

Remarks

The precise meaning of the STG_E_ACCESSDENIED return value is implementation-specific. When you implement the InstancePropertyStoreValidateAccess method, you can return STG_E_ACCESSDENIED for any supplied dwStgAccess mode value on any supplied function instance.

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