IMDSPDevice3::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 Device Manager のすべてのインターフェイスメソッドは、次のいずれかのクラスのエラーコードを返すことができます。

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

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

アプリケーションは、後でこの永続的な一意識別子 FindStorage を呼び出すことができます。応答として、Windows Media Device Manager はサービスプロバイダー (SP) でこのメソッドを呼び出します。

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

Windows Media Device Manager は、Windows Media Player との同期を有効にするために登録されているデバイスに対してのみ、このメソッドを呼び出します。詳細については、「Windows Media Playerとの同期を有効にする」を参照してください。