IWMDMDevice3::FindStorage メソッド (mswmdm.h)

[アーティクル]
08/25/2023

FindStorage メソッドは、永続的な一意識別子によってストレージを検索します。他のメソッドとは異なり、このメソッドはルートストレージから再帰的に検索できます。

構文

HRESULT FindStorage(
  [in]  WMDM_FIND_SCOPE findScope,
  [in]  LPCWSTR         pwszUniqueID,
  [out] IWMDMStorage    **ppStorage
);

パラメーター

[in] findScope

検索操作のスコープを指定する WMDM_FIND_SCOPE 列挙。

[in] pwszUniqueID

ストレージの g_wszWMDMPersistentUniqueID プロパティのクエリを実行して取得できる、ストレージの永続的な一意識別子を表す、null で終わるワイド文字の文字列。

[out] ppStorage

返されたストレージへのポインター。呼び出し元は、このインターフェイスが完了したら、このインターフェイスを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

標準 COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media デバイスマネージャーエラーコード

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

注釈

永続的な一意識別子は、特定のデバイスに格納されているコンテンツを一意に識別するために使用されます。すべてのデバイスで同じままのコンテンツ固有のグローバル一意識別子を表すわけではありません。したがって、異なるストレージに格納されている同じコンテンツは、異なる永続的な一意識別子を持つことになります。同様に、異なるコンテンツは、異なるデバイスに格納されている場合に、同じ永続的な一意識別子を持つことができます。このプロパティは、データベース内の行に似ているデバイス上のコンテンツの類似点を使用して、ID 列がデータベースで機能するのと同じ目的を果たします。

デバイスによって生成されるため、永続的な一意識別子の形式はデバイスに依存します。アプリケーションは、ストレージの g_wszWMDMPersistentUniqueID プロパティに対してクエリを実行して、永続的な一意識別子を取得する必要があります。アプリケーションでは、 GetSpecifiedMetadata メソッドまたは GetMetadata メソッドを使用して、このプロパティのクエリを実行できます。