Metode IWDFNamedPropertyStore::GetNamedValue (wudfddi.h)
[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]
Metode GetNamedValue mengambil nilai properti.
Sintaks
HRESULT GetNamedValue(
[in] LPCWSTR pszName,
[out] PROPVARIANT *pv
);
Parameter
[in] pszName
Penunjuk ke string yang dihentikan null yang berisi nama properti .
[out] pv
Penunjuk ke variabel yang menerima nilai untuk properti .
Nilai kembali
GetNamedValue mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang ditentukan dalam Winerror.h.
Keterangan
Metode GetNamedValue mengalokasikan memori untuk string dalam struktur PROPVARIANT yang diarahkan oleh parameter pv . Pemanggil kemudian harus membebaskan memori ini dengan memanggil fungsi PropVariantClear , seperti yang ditunjukkan dalam cuplikan berikut:
hr = pPropStore->GetNamedValue(L"Host", &val);
...
PropVariantClear(&val);Jika pemanggil tidak membebaskan memori, kebocoran memori dapat mengakibatkan.
Jenis varian berikut didukung untuk nilai properti. Tabel berikut ini memperlihatkan jenis varian yang dikembalikan terlepas dari jenis varian aslinya.
| Jenis varian | Jenis varian diambil |
|---|---|
| VT_BSTR | Saat klien membaca nilai string, nilai dikembalikan sebagai VT_LPWSTR terlepas dari jenis varian asli yang digunakan untuk menulis nilai. |
| VT_LPWSTR | |
| VT_LPSTR | |
| VT_I1 | Saat klien membaca nilai bilangan bulat, nilai dikembalikan sebagai VT_UI4 terlepas dari jenis varian asli yang digunakan untuk menulis nilai. |
| VT_UI1 | |
| VT_I2 | |
| VT_UI2 | |
| VT_I4 | |
| VT_UI4 | |
| VT_UINT | |
| VT_BLOB | Nilai biner dikembalikan sebagai VT_BLOB. |
| VT_VECTOR | VT_LPWSTR | Array string dikembalikan sebagai VT_VECTOR | VT_LPWSTR |
String yang berisi variabel lingkungan diperluas saat dibaca.
Untuk informasi selengkapnya, lihat Menggunakan Registri di Driver berbasis UMDF.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Akhir dukungan | Tidak tersedia di UMDF 2.0 dan yang lebih baru. |
| Target Platform | Desktop |
| Versi UMDF minimum | 1,5 |
| Header | wudfddi.h (termasuk Wudfddi.h) |
| DLL | WUDFx.dll |