Metode IWiaDrvItem::GetFullItemName (wiamindr_lh.h)
Metode IWiaDrvItem::GetFullItemName mendapatkan nama lengkap item, termasuk informasi jalur.
Sintaks
HRESULT GetFullItemName(
BSTR *__MIDL__IWiaDrvItem0002
);
Parameter
__MIDL__IWiaDrvItem0002
pbstrFullItemName [keluar, opsional]
Menunjuk ke lokasi memori yang akan menerima alamat string yang berisi nama lengkap item.
Nilai kembali
Jika metode berhasil, metode menyimpan penunjuk ke nama lengkap item, termasuk informasi jalur, di pbstrFullItemName dan mengembalikan S_OK. Jika metode gagal mengalokasikan string karena memori yang tidak mencukup, metode akan mengembalikan E_OUTOFMEMORY. Jika parameter pbstrFullItemName tidak valid, metode akan mengembalikan E_INVALIDARG. Jika metode gagal karena alasan lain, metode mengembalikan kode kesalahan COM standar.
Keterangan
Jika memori tersedia cukup, metode ini mengalokasikan string yang berisi nama lengkap item saat ini termasuk informasi jalur. Metode mengembalikan penunjuk ke string di pbstrFullItemName. Minidriver harus membatalkan alokasi memori yang digunakan oleh string dengan memanggil fungsi SysFreeString .
Nama yang dikembalikan dalam pbstrFullItemName adalah nama yang terkait dengan item ketika item pertama kali dibuat oleh fungsi pustaka layanan driver wiasCreateDrvItem.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | wiamindr_lh.h (termasuk Wiamindr.h) |