Metode IFunctionInstance::OpenPropertyStore (functiondiscoveryapi.h)

[Penemuan Fungsi tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Membuka penyimpanan properti untuk instans fungsi. Penyimpanan properti berisi metadata tentang instans fungsi, seperti namanya, ikon, tanggal penginstalan, dan informasi lainnya.

Sintaks

HRESULT OpenPropertyStore(
  [in]  DWORD          dwStgAccess,
  [out] IPropertyStore **ppIPropertyStore
);

Parameter

[in] dwStgAccess

Mode akses yang akan ditetapkan ke aliran terbuka. Untuk metode ini, mode akses berikut didukung:

STGM_READ

STGM_READWRITE

STGM_WRITE

[out] ppIPropertyStore

Penunjuk ke penunjuk antarmuka IPropertyStore .

Mengembalikan nilai

Kemungkinan nilai yang dikembalikan termasuk, tetapi tidak terbatas pada, berikut ini.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.
STG_E_ACCESSDENIED
 Metode tidak dapat membuka penyimpanan properti bisa-tulis karena pemanggil tidak memiliki akses yang cukup atau penyedia penemuan tidak memperbolehkan akses tulis ke penyimpanan propertinya.
E_INVALIDARG
 Nilai dwStgAccess tidak valid.
E_POINTER
 ppIPropertyStore menunjuk ke memori yang tidak valid.
E_OUTOFMEMORY
 Metode tidak dapat mengalokasikan memori yang diperlukan untuk melakukan operasi ini.

Keterangan

Hanya satu penyimpanan properti per instans fungsi yang dapat dibuka pada satu waktu. Jika OpenPropertyStore dipanggil dua kali pada instans fungsi yang sama, kedua pointer ppIPropertyStore akan menunjuk ke penyimpanan properti yang sama. Selain itu, mode akses (seperti yang ditentukan oleh parameter dwStgAccess ) akan ditentukan oleh panggilan OpenPropertyStore terbaru. Aplikasi harus memanggil Rilis untuk menutup penyimpanan properti sebelum membuka yang lain.

Ada kemungkinan bahwa OpenPropertyStore akan mengembalikan penyimpanan properti untuk perangkat yang telah dihapus. Dalam hal ini, kunci properti di penyimpanan akan kosong. Situasi ini dapat terjadi jika devnode perangkat dihapus tetapi penyimpanan properti yang terkait dengan instans fungsi perangkat masih dapat diakses. Situasi ini jarang terjadi.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header functiondiscoveryapi.h
DLL FunDisc.dll

Lihat juga

IFunctionInstance

  • Last updated on