IMMDevice::Metode OpenPropertyStore (mmdeviceapi.h)
Metode OpenPropertyStore mengambil antarmuka ke penyimpanan properti perangkat.
Sintaks
HRESULT OpenPropertyStore(
[in] DWORD stgmAccess,
[out] IPropertyStore **ppProperties
);
Parameter
[in] stgmAccess
Mode akses penyimpanan. Parameter ini menentukan apakah akan membuka penyimpanan properti dalam mode baca, mode tulis, atau mode baca/tulis. Atur parameter ini ke salah satu konstanta STGM berikut:
STGM_READ
STGM_WRITE
STGM_READWRITE
Metode ini memungkinkan klien yang berjalan sebagai administrator untuk membuka penyimpanan untuk akses baca-saja, tulis-saja, atau baca/tulis. Klien yang tidak berjalan sebagai administrator dibatasi untuk akses baca-saja. Untuk informasi selengkapnya tentang konstanta STGM, lihat dokumentasi Windows SDK.
[out] ppProperties
Arahkan ke variabel pointer tempat metode menulis alamat antarmuka IPropertyStore dari penyimpanan properti perangkat. Melalui metode ini, pemanggil mendapatkan referensi yang dihitung ke antarmuka. Pemanggil bertanggung jawab untuk merilis antarmuka, ketika tidak lagi diperlukan, dengan memanggil metode Rilis antarmuka. Jika panggilan OpenPropertyStore gagal, *ppProperties adalah NULL. Untuk informasi selengkapnya tentang IPropertyStore, lihat dokumentasi Windows SDK.
Menampilkan nilai
Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian disertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Parameter stgmAccess bukan mode akses yang valid. |
|
Parameter ppProperties adalah NULL. |
|
Kehabisan memori. |
Keterangan
Secara umum, properti di penyimpanan properti perangkat bersifat baca-saja untuk klien yang tidak melakukan fungsi administratif, sistem, atau layanan.
Untuk contoh kode yang memanggil metode OpenPropertyStore , lihat topik berikut:
Persyaratan
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | mmdeviceapi.h |