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

FindStorage メソッドは、指定された永続的な一意識別子を持つストレージを検索します。ストレージの永続的な一意識別子は、そのストレージの g_wszWMDMPersistentUniqueID プロパティによって記述されます。

構文

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

[in] findScope

検索操作のスコープ。次のいずれかの値を指定する必要があります。

値	説明
WMDM_FIND_SCOPE_GLOBAL	デバイス全体を検索します。
WMDM_FIND_SCOPE_IMMEDIATE_CHILDREN	現在のストレージの直接の子でのみ検索します。

[in] pwszUniqueID

ストレージの永続的な一意識別子。

[out] ppStorage

pwszUniqueID パラメーターで指定された、返されるストレージへのポインター。

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

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

サービスプロバイダーは、ストレージの g_wszWMDMPersistentUniqueID プロパティを介して永続的な一意識別子を返します。特定のストレージの場合、サービスプロバイダーによって提供される永続的な一意識別子は、異なるデバイス接続セッション間で同じである必要があります。

アプリケーションでは、後でこの永続的な一意識別子を使用して FindStorage を呼び出すことができます。これに対して、Windows Media デバイスマネージャーはサービスプロバイダーでこのメソッドを呼び出します。

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

このメソッドを使用すると、永続的な一意識別子に基づいてストレージを検索できます。 IMDSPStorage2::GetStorage では、名前に基づいてストレージを検索できます。

Windows Media デバイスマネージャーは、Windows メディアプレーヤーと同期できるデバイスに対してのみ、このメソッドを呼び出します。詳細については、「Windows メディアプレーヤーを使用した同期の有効化」を参照してください。