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