METODE IMDSPStorage2::GetStorage (mswmdm.h)

Artikel
08/25/2023

Metode GetStorage memungkinkan untuk langsung masuk ke objek penyimpanan dari nama penyimpanan alih-alih menghitung melalui semua penyimpanan untuk menemukannya.

Sintaks

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

Parameter

[in] pszStorageName

Penunjuk ke string yang dihentikan null yang berisi nama penyimpanan.

[out] ppStorage

Penunjuk ke objek penyimpanan yang ditentukan oleh pszStorageName, atau NULL jika tidak ada penyimpanan seperti itu yang ditemukan.

Nilai kembali

Metode mengembalikan HRESULT. Semua metode antarmuka di Windows Media Device Manager dapat mengembalikan salah satu kelas kode kesalahan berikut:

Kode kesalahan COM standar
Kode kesalahan Windows dikonversi ke nilai HRESULT
Kode kesalahan Pengelola Perangkat Windows Media

Untuk daftar ekstensif kemungkinan kode kesalahan, lihat Kode Kesalahan.

Keterangan

Antarmuka IMDSPStorage2::GetStorage memperluas fungsi IMDSPStorage.

IMDSPStorage2::GetStorage tidak mendukung karakter kartubebas. Ini tidak rekursif, yaitu, hanya akan menemukan objek penyimpanan di penyimpanan saat ini.

Jika metode ini tidak diimplementasikan, metode ini harus mengembalikan E_NOTIMPL. (Ini tidak boleh mengembalikan WMDM_E_NOT_SUPPORTED atau kode lain yang menunjukkan bahwa metode ini tidak diimplementasikan). Ini akan memastikan bahwa Windows Media Device Manager akan mencoba mengganti fungsionalitas ini sendiri dengan menghitung semua penyimpanan untuk menemukan kecocokan berdasarkan nama penyimpanan yang diteruskan sebagai pszStorageName.

Sangat disarankan agar penyedia layanan menerapkan metode ini untuk mengembalikan objek penyimpanan secara efisien berdasarkan nama.

Metode ini bersifat opsional. Untuk informasi selengkapnya, lihat Antarmuka Wajib dan Opsional.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	mswmdm.h
Pustaka	Mssachlp.lib

Lihat juga

Antarmuka IMDSPStorage

Antarmuka IMDSPStorage2

Bagikan melalui