IFunctionDiscoveryProvider：：Initialize 方法 (functiondiscoveryprovider.h)

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

初始化函数发现提供程序对象。 此方法应在创建 对象后立即调用。

语法

HRESULT Initialize(
  [in]  IFunctionDiscoveryProviderFactory *pIFunctionDiscoveryProviderFactory,
  [in]  IFunctionDiscoveryNotification    *pIFunctionDiscoveryNotification,
  [in]  LCID                              lcidUserDefault,
  [out] DWORD                             *pdwStgAccessCapabilities
);

参数

[in] pIFunctionDiscoveryProviderFactory

指向 IFunctionDiscoveryProviderFactory 接口的 指针。 提供程序应使用此接口创建新的 Function Discovery 对象。

[in] pIFunctionDiscoveryNotification

指向 IFunctionDiscoveryNotification 接口的指针。 提供程序应使用此接口将 OnUpdate、 OnEvent 和 OnError 通知发送到函数发现通知队列。 函数发现将排队通知发送到客户端程序。

[in] lcidUserDefault

调用方的区域设置标识符。 提供程序应使用 lcidUserDefault 返回提供程序枚举的资源的本地化字符串。

[out] pdwStgAccessCapabilities

指定与此提供程序创建的函数实例关联的属性存储的可能限制最少的访问模式。

如果 DWORD 值设置为 -1，则每次在此提供程序创建的函数实例上调用 OpenPropertyStore 时，都会调用 InstancePropertyStoreValidateAccess。 否则，此参数指定的值确定与此提供程序创建的所有函数实例关联的所有属性存储的可能访问模式限制最少。 如果客户端调用 OpenPropertyStore 且 dwStgAccess 参数设置为比指定的 pdwStgAccessCapabilities 值更严格的值，则会对单个属性存储应用更严格的访问模式。

为了提高效率，请尽可能指定 pdwStgAccessCapabilities 值。

支持以下模式：

STGM_READ

STGM_READWRITE

STGM_WRITE

返回值

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

返回代码	说明
S_OK	该方法已成功完成。
E_INVALIDARG	其中一个参数包含无效参数。

备注

如果提供程序要创建 Function Discovery 对象、队列通知或枚举具有本地化字符串的资源，则必须在 上调用 AddRef ，并缓存初始化的 pIFunctionDiscoveryProviderFactory、 pIFunctionDiscoveryNotification 和 lcidUserDefault 参数，以便在以后实现 Initialize 方法时使用。

要求

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

请参阅

IFunctionDiscoveryProvider