次の方法で共有


IMDSPDevice2::GetStorage メソッド (mswmdm.h)

GetStorage メソッドを使用すると、すべてのストレージを列挙して検索する代わりに、その名前に基づいてストレージに直接移動できます。

構文

HRESULT GetStorage(
  [in]  LPCWSTR      pszStorageName,
  [out] IMDSPStorage **ppStorage
);

パラメーター

[in] pszStorageName

検索するストレージの名前を含む null で終わる文字列へのポインター。

[out] ppStorage

pszStorageName パラメーターで指定されたストレージ オブジェクトへのポインター。

戻り値

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

  • 標準 COM エラー コード
  • HRESULT 値に変換された Windows エラー コード
  • Windows Media デバイス マネージャー エラー コード
考えられるエラー コードの詳細な一覧については、「 エラー コード」を参照してください。

注釈

GetStorage メソッドでは、ワイルドカード文字はサポートされていません。 再帰的ではありません。つまり、デバイスのルートにのみストレージが見つかります。

このメソッドが実装されていない場合は、E_NOTIMPLを返す必要があります。 (このメソッドが実装されていないことを示すWMDM_E_NOT_SUPPORTEDまたはその他のコードを返さないでください)。 これにより、Windows Media デバイス マネージャーは、pszStorageName として渡されたストレージ名に基づいて一致するものを見つけるためにすべてのストレージを列挙することで、この機能自体を置き換えようとします。

名前に基づいてストレージ オブジェクトを効率的に返すには、サービス プロバイダーがこのメソッドを実装することを強くお勧めします。

このメソッドは省略可能です。 詳細については、「 必須インターフェイスと省略可能なインターフェイス」を参照してください。

要件

要件
対象プラットフォーム Windows
ヘッダー mswmdm.h
Library Mssachlp.lib

こちらもご覧ください

IMDSPDevice2 インターフェイス