IWDFNamedPropertyStore2：:D eleteNamedValue 方法 (wudfddi.h)

  • 發行項

[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，且較新版本的 #D4C30D58248E6411A92B0FF8333DF6C75 上，UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱使用 UMDF 使用者入門。]

DeleteNamedValue 方法會從登錄中刪除值名稱。

語法

HRESULT DeleteNamedValue(
  [in] LPCWSTR pwszName
);

參數

[in] pwszName

包含登錄值名稱之 Null 終止字串的指標。

傳回值

如果作業成功，DeleteNamedValue 會傳回S_OK。 否則，方法可能會傳回下列值：

傳回碼 Description
E_INVALIDARG
 呼叫端提供了無效的輸入自變數。
 

這個方法可能會傳回 Winerror.h 包含的其他其中一個值。

備註

在驅動程式呼叫 DeleteNamedValue 之前，它必須先呼叫 IWDFPropertyStoreFactory：：RetrieveDevicePropertyStore ，才能取得 IWDFNamedPropertyStore2 介面。

如需存取登錄的詳細資訊，請參閱 在 UMDF 型驅動程式中使用登錄。

範例

下列程式代碼範例是裝置物件的 IObjectCleanup：：OnCleanup 回 呼函式。 如果驅動程式先前已將值新增至登錄的 DEVICEMAP 機碼，回呼函式會刪除該值。

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;
    }    
}

規格需求

需求 值
終止支援 在 UMDF 2.0 和更新版本中無法使用。
目標平台 桌面
最低UMDF版本 1.9
標頭 wudfddi.h (包含 Wudfddi.h)
Dll WUDFx.dll

另請參閱

IWDFNamedPropertyStore2

IWDFPropertyStoreFactory：：RetrieveDevicePropertyStore