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 傳入的記憶體名稱來尋找相符專案，以嘗試取代此功能本身。

強烈建議服務提供者實作此方法，以根據名稱有效率地傳回記憶體物件。

這個方法是一個選擇項目。 如需詳細資訊，請參閱 強制和選擇性介面。

規格需求

另請參閱

IMDSPDevice2 介面