次の方法で共有

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

  • [アーティクル]

GetStorage メソッドを使用すると、すべてのストレージを列挙して見つけるのではなく、ストレージ名からストレージ オブジェクトに直接移動できます。

構文

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

パラメーター

[in] pszStorageName

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

[out] ppStorage

pszStorageName で指定されたストレージ オブジェクトへのポインター。そのようなストレージが見つからない場合は NULL。

戻り値

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

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

注釈

IMDSPStorage2::GetStorage インターフェイスは、IMDSPStorage の機能を拡張します。

IMDSPStorage2::GetStorage ではワイルドカード文字はサポートされていません。 再帰ではなく、現在のストレージ内のストレージ オブジェクトのみを検索します。

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

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

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

要件

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

こちらもご覧ください

IMDSPStorage インターフェイス

IMDSPStorage2 インターフェイス