IFunctionDiscoveryProvider

これは検出プロバイダーが実装するメインのインターフェイスです。Function Discovery インフラストラクチャがプロバイダーおよびそのリソースと通信するために使用する主要なインターフェイスです。

Function Discovery プロバイダーオブジェクトを初期化します。

可能な戻り値には次のものがありますが、これらに限定されません。

プロバイダーで Function Discovery オブジェクトの作成、通知のキュー登録、またはローカライズされた文字列を含むリソースの列挙を行う場合は、Initialize メソッドを実装する際に、後で使用できるように、初期化された pIFunctionDiscoveryProviderFactory、pIFunctionDiscoveryNotification、lcidUserDefault の各パラメーターに対して AddRef を呼び出してキャッシュしておく必要があります。

指定された制約を満たす関数インスタンスのコレクションを取得します。

可能な戻り値には次のものがありますが、これらに限定されません。

アクティブなクエリは、EndQuery メソッドの呼び出しによって Function Discovery が終了させます。EndQuery は、クライアントがそのクエリに対して IFunctionDiscoveryNotification インターフェイスを指定した場合にのみ呼び出される点に注意してください。IFunctionDiscoveryNotification が指定されなかった場合、Query の呼び出しが完了した時点で、そのクエリはプロバイダーによって終了したものと見なす必要があります。

クライアントは、前回の Query 呼び出しが返された後であれば、いつでもクエリを再実行できます。Query の実装は、新しいクエリに対して IFunctionInstanceCollection を返せる必要があります。EndQuery が後続の Query 呼び出しの前に呼び出されるのは、クライアントがプロバイダーの Initialize メソッドに IFunctionDiscoveryNotification インターフェイスを渡した場合のみです。

Query が E_PENDING を返す場合、プロバイダーは、結果の列挙が完了したことを示すために、IFunctionDiscoveryNotification インターフェイスの OnEvent メソッドを FD_EVENTID_SEARCHCOMPLETE を指定して呼び出す必要があります。FD_EVENTID_SEARCHCOMPLETE イベントの送信に失敗すると、クライアントが無期限にハングする可能性があります。

プロバイダーが実行しているクエリを終了します。

可能な戻り値には次のものがありますが、これらに限定されません。

このメソッドは、それ以上のクエリ通知が IFunctionDiscoveryNotification コールバックインターフェイスに送信されないことをプロバイダーに通知するために、Function Discovery によって呼び出されます。実装者は、EndQuery の呼び出しが返された後に、それ以上のクエリ通知が Function Discovery に送信されないようにする必要があります。プロバイダーの実装が EndQuery の戻り後に通知を送信した場合、Function Discovery はプロバイダーにエラーを返し、その通知はクライアントに転送されません。

EndQuery が呼び出されるのは、クライアントがプロバイダーの Initialize メソッドに IFunctionDiscoveryNotification インターフェイスを渡した場合のみです。

クエリに関連付けられたデータ構造はすべて、EndQuery の実装内で削除できます。Query メソッドによって割り当てられたプライベートなコンテキストメモリもすべて削除する必要があります。

EndQuery が返された後は、Query を再度呼び出せる点に注意してください。

要求されたアクセスをプロバイダーがサポートしているかを検証します。

可能な戻り値には次のものがありますが、これらに限定されません。

STG_E_ACCESSDENIED という戻り値の正確な意味は実装によって異なります。InstancePropertyStoreValidateAccess メソッドを実装する際は、渡された任意の関数インスタンスに対して、渡された任意の dwStgAccess モード値について STG_E_ACCESSDENIED を返すことができます。

プロバイダーのプロパティストアを開きます。

可能な戻り値には次のものがありますが、これらに限定されません。

プロバイダーがプロパティを永続化するためのメカニズムを提供します。

このメソッドは次のいずれかの値を返すことがあります。

可能な戻り値には次のものがありますが、これらに限定されません。

プロバイダーが SetValue を通じて渡された新しい値をメモリ内にキャッシュしている場合、このメソッドは、更新された値を基盤となる API/ストアに永続化するコードを実装する必要があります。

このメソッドを実装する場合は、データを永続化する前に OpenPropertyStore を呼び出して現在のプロパティストアを返す必要があります。

関数インスタンス用のプロバイダー固有の COM オブジェクトを作成します。

可能な戻り値には次のものがありますが、これらに限定されません。

InstanceQueryService は、guidService で識別されるサービスの実装を作成またはそれにアクセスし、riid で指定されたインターフェイスのアドレスを ppv 引数で返します。プロバイダーはサービスを実装でき、このメソッドは、サービスを実装するための新しいオブジェクトの作成を必要とせずに、プロバイダーがこの実装を提供するためのメカニズムを提供します。

guidService がこのプロバイダーに属していない場合、または riid インターフェイスがサポートされていない場合、プロバイダーは E_NOINTERFACE を返す必要があります。このメソッドを単に実装していない場合、または要求された SID を実装していない場合、プロバイダーは E_NOTIMPL を返す必要があります。

埋め込みサービスまたはデバイスをサポートするプロバイダーは、SID_PNPXServiceCollection サービスを実装する必要があります。SID_PNPXServiceCollection サービスがサポートされている場合、クライアントは IFunctionInstance::QueryService を呼び出して、埋め込みサービスまたはデバイスに関連付けられた情報やメタデータにアクセスできます。たとえば、PnP-X プロバイダー (つまり SSDP プロバイダー と WSD プロバイダー) は、SID_PNPXServiceCollection サービスのサポートを実装しています。すべてのプロバイダーが SID_PNPXServiceCollection サービスのサポートを実装しているわけではありません。

指定された関数インスタンスを解放し、以前に割り当てられたメモリを解放します。

このメソッドは次のいずれかの値を返すことがあります。

可能な戻り値には次のものがありますが、これらに限定されません。

このメソッドを実装する際は、必要に応じて ppvProviderInstanceContext 用に割り当てられたメモリをクリーンアップする必要があります。