IFunctionDiscoveryProvider：：Initialize 方法 (functiondiscoveryprovider.h)

[函式探索可用於需求一節中指定的作業系統。 它可能會在後續版本中改變或無法使用。]

初始化函式探索提供者物件。 這個方法的目的是在建立 物件之後立即呼叫。

語法

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

參數

[in] pIFunctionDiscoveryProviderFactory

IFunctionDiscoveryProviderFactory介面的指標。 提供者應該使用此介面來建立新的函式探索物件。

[in] pIFunctionDiscoveryNotification

IFunctionDiscoveryNotification介面的指標。 提供者應該使用此介面，將 OnUpdate、 OnEvent和 OnError 通知傳送至函式探索通知佇列。 佇列通知會透過函式探索傳送至用戶端程式。

[in] lcidUserDefault

呼叫端的地區設定識別碼。 提供者應該使用 lcidUserDefault 傳回提供者所列舉資源的當地語系化字串。

[out] pdwStgAccessCapabilities

指定與這個提供者所建立之函式實例相關聯的屬性存放區最不嚴格的可能存取模式。

如果 DWORD 值設定為 -1，每次在此提供者所建立的函式實例上呼叫 OpenPropertyStore 時，都會呼叫InstancePropertyStoreValidateAccess。 否則，此參數所指定的值會決定與此提供者所建立之所有函式實例相關聯之所有屬性存放區的最低限制可能存取模式。 如果 用戶端呼叫dwStgAccess 參數設定為比指定 pdwStgAccessCapabilities 值更嚴格的值，則會將更嚴格的存取模式套用至個別屬性存放區。

為了有效率，請盡可能指定 pdwStgAccessCapabilities 值。

支援下列模式：

STGM_READ

STGM_READWRITE

STGM_WRITE

傳回值

可能的傳回值包括，但不限於下列各項。

傳回碼	描述
S_OK	已成功完成命令。
E_INVALIDARG	其中一個參數包含不正確引數。

備註

如果您的提供者將建立函式探索物件、佇列通知或列舉具有當地語系化字串的資源，您必須呼叫 AddRef on 並快取初始化的 pIFunctionDiscoveryProviderFactory、 pIFunctionDiscoveryNotification和 lcidUserDefault 參數，以便稍後在實作 Initialize 方法時使用。

需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	functiondiscoveryprovider.h

另請參閱

IFunctionDiscoveryProvider