Metode IWDFNamedPropertyStore2::D eleteNamedValue (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 DeleteNamedValue menghapus nama nilai dari registri.

Sintaks

HRESULT DeleteNamedValue(
  [in] LPCWSTR pwszName
);

Parameter

[in] pwszName

Penunjuk ke string yang dihentikan null yang berisi nama nilai registri.

Mengembalikan nilai

DeleteNamedValue mengembalikan S_OK jika operasi berhasil. Jika tidak, metode mungkin mengembalikan nilai berikut:

Menampilkan kode Deskripsi
E_INVALIDARG
Pemanggil menyediakan argumen input yang tidak valid.
 

Metode ini mungkin mengembalikan salah satu nilai lain yang dikandung Winerror.h.

Keterangan

Sebelum driver memanggil DeleteNamedValue, driver harus memanggil IWDFPropertyStoreFactory::RetrieveDevicePropertyStore untuk mendapatkan antarmuka IWDFNamedPropertyStore2 .

Untuk informasi selengkapnya tentang mengakses registri, lihat Menggunakan Registri di Driver berbasis UMDF.

Contoh

Contoh kode berikut adalah fungsi panggilan balik IObjectCleanup::OnCleanup untuk objek perangkat. Jika sebelumnya driver telah menambahkan nilai ke kunci DEVICEMAP registri, fungsi panggilan balik akan menghapus nilai .

VOID 
CMyDevice::OnCleanup(
 IWDFObject*  pWdfObject
)
{
    UNREFERENCED_PARAMETER(pWdfObject);
 
    if ((m_CreatedLegacyHardwareKey == TRUE) && 
        (m_LegacyHardwarePropertyStore != NULL))
    {
        m_LegacyHardwarePropertyStore->DeleteNamedValue(m_PdoName);
        SAFE_RELEASE(m_LegacyHardwarePropertyStore);
        delete[] m_PdoName;
    }    
}

Persyaratan

   
Akhir dukungan Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform Desktop
Versi UMDF minimum 1.9
Header wudfddi.h (termasuk Wudfddi.h)
DLL WUDFx.dll

Lihat juga

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory::RetrieveDevicePropertyStore