IMMDevice::Metode OpenPropertyStore (mmdeviceapi.h)

  • Artikel

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
E_INVALIDARG
 Parameter stgmAccess bukan mode akses yang valid.
E_POINTER
 Parameter ppProperties adalah NULL.
E_OUTOFMEMORY
 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

Lihat juga

Antarmuka IMMDevice