IWDFNamedPropertyStore2::D eleteNamedValue 메서드(wudfddi.h)

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용한 시작 참조하세요.]

DeleteNamedValue 메서드는 레지스트리에서 값 이름을 삭제합니다.

구문

HRESULT DeleteNamedValue(
  [in] LPCWSTR pwszName
);

매개 변수

[in] pwszName

레지스트리 값 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

반환 값

DeleteNamedValue는 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 메서드가 다음 값을 반환할 수 있습니다.

반환 코드 설명
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