IFunctionDiscoveryProvider：：InstancePropertyStoreValidateAccess 方法 (functiondiscoveryprovider.h)

[函数发现可用于“要求”部分中指定的操作系统。 它在后续版本中可能已更改或不可用。]

验证提供程序是否支持请求的访问。 在函数实例上调用 OpenPropertyStore 以验证提供程序是否支持 dwStgAccess 参数传递的访问模式时，将调用它。

仅当提供程序的 Initialize 方法返回 pdwStgAccessCapabilities 参数值 -1 时，才会调用此方法。

语法

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

参数

[in] pIFunctionInstance

指向 IFunctionInstance 接口的 指针。

[in] iProviderInstanceContext

与特定函数实例关联的上下文。

[in] dwStgAccess

要验证的访问模式。 对于此方法，支持以下模式：

STGM_READ

STGM_READWRITE

STGM_WRITE

返回值

可能的返回值包括但不限于以下值。

返回代码	说明
S_OK	该方法已成功完成。
E_NOTIMPL	提供程序不实现实例属性存储。
STG_E_ACCESSDENIED	方法无法打开可写属性存储，因为调用方的访问权限不足，发现提供程序不允许对其属性存储区进行写入访问，或者已为此函数实例打开另一个属性存储区。
E_INVALIDARG	dwStgAccess 的值无效。
E_OUTOFMEMORY	方法无法分配执行此操作所需的内存。

注解

STG_E_ACCESSDENIED返回值的精确含义特定于实现。 实现 InstancePropertyStoreValidateAccess 方法时，可以为任何提供的函数实例上提供的任何 dwStgAccess 模式值返回STG_E_ACCESSDENIED。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	functiondiscoveryprovider.h

另请参阅

IFunctionDiscoveryProvider