次の方法で共有

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 が呼び出されます。 それ以外の場合、このパラメーターで指定された値は、このプロバイダーによって作成されたすべての関数インスタンスに関連付けられているすべてのプロパティ ストアに対して、最も制限の厳しいアクセス モードを決定します。 クライアントが dwStgAccess パラメーターを指定した pdwStgAccessCapabilities 値よりも制限の厳しい値に設定して OpenPropertyStore を呼び出す場合は、より制限の厳しいアクセス モードが個々のプロパティ ストアに適用されます。

効率を高める場合は、可能な限り 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

  • Last updated on