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 |