다음을 통해 공유

WdfRegistryRemoveValue 함수(wdfregistry.h)

  • 아티클

[KMDF 및 UMDF에 적용]

WdfRegistryRemoveValue 메서드는 지정된 레지스트리 키에서 지정된 값과 해당 데이터를 제거합니다.

구문

NTSTATUS WdfRegistryRemoveValue(
  [in] WDFKEY           Key,
  [in] PCUNICODE_STRING ValueName
);

매개 변수

[in] Key

열린 레지스트리 키를 나타내는 레지스트리 키 개체에 대한 핸들입니다.

[in] ValueName

값 이름을 포함하는 UNICODE_STRING 구조체에 대한 포인터입니다.

반환 값

WdfRegistryRemoveValue 는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 메서드는 다음 값 중 하나를 반환할 수 있습니다.

반환 코드 설명
STATUS_INVALID_DEVICE_REQUEST

WdfRegistryRemoveValue 는 IRQL = PASSIVE_LEVEL 호출되지 않았습니다.
STATUS_INVALID_PARAMETER
 잘못된 매개 변수가 지정되었습니다.
STATUS_ACCESS_DENIED
 드라이버가 KEY_SET_VALUE 액세스 권한이 있는 레지스트리 키를 열지 않았습니다.
 

이 메서드는 다른 NTSTATUS 값을 반환할 수도 있습니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

레지스트리 키 개체에 대한 자세한 내용은 Framework-Based 드라이버에서 레지스트리 사용을 참조하세요.

예제

다음 코드 예제에서는 지정된 레지스트리 키에서 MyValue 값 및 해당 데이터를 제거합니다.

DECLARE_CONST_UNICODE_STRING(valueName, L"MyValue");

status = WdfRegistryRemoveValue(
                                Key,
                                &valueName
                                );

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
최소 UMDF 버전 2.0
머리글 wdfregistry.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL PASSIVE_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

UNICODE_STRING