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

[アーティクル]
03/05/2024

FindStorage メソッドは、永続的な一意識別子に基づいて、現在のルートストレージ内のストレージを取得します。

構文

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

パラメーター

[in] findScope

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

[in] pwszUniqueID

見つかるストレージの永続的な一意識別子。ストレージの永続的な一意識別子は、ストレージの g_wszWMDMPersistentUniqueID メタデータプロパティによって記述されます。

[out] ppStorage

見つかった場合は、取得したストレージへのポインター。呼び出し元は、このインターフェイスが完了したら、このインターフェイスを解放する必要があります。

戻り値

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

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

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

注釈

このメソッドは、デバイス上の 1 つのメモリオブジェクト (フラッシュカードまたはハードディスク) のみを検索します。

永続的な一意識別子は、特定のデバイスに格納されているコンテンツを識別します。すべてのデバイスで同じままのコンテンツ固有のグローバル一意識別子を表すわけではありません。したがって、異なるストレージに格納されている同じコンテンツは、異なる永続的な一意識別子を持つことになります。同様に、異なるコンテンツが異なるデバイスに格納されている場合、同じ永続的な一意識別子を持つ場合があります。

永続的な一意識別子の形式は、デバイスによって異なります。アプリケーションは、ストレージを取得し、 WMDM/PersistentUniqueID プロパティに対してクエリを実行することで、以前に永続的な一意識別子を取得している必要があります。このプロパティを要求するには、 GetSpecifiedMetadata メソッドまたは GetMetadata メソッドを使用します。