다음을 통해 공유


IWiaMiniDrv::d rvDeleteItem 메서드(wiamindr_lh.h)

IWiaMiniDrv::d rvDeleteItem 메서드는 현재 드라이버 항목을 삭제합니다.

구문

HRESULT drvDeleteItem(
  BYTE *__MIDL__IWiaMiniDrv0053,
  LONG __MIDL__IWiaMiniDrv0054,
  LONG *__MIDL__IWiaMiniDrv0055
);

매개 변수

__MIDL__IWiaMiniDrv0053

lFlags [in]

예약되어 있습니다.

__MIDL__IWiaMiniDrv0054

pWiasContext [in]

WIA 항목 컨텍스트에 대한 포인터입니다.

__MIDL__IWiaMiniDrv0055

plDevErrVal [out]

이 메서드에 대한 상태 코드를 받을 메모리 위치를 가리킵니다. 이 메서드가 S_OK 반환하면 저장된 값은 0이 됩니다. 그렇지 않으면 미니 드라이버 관련 오류 코드가 이 매개 변수가 가리키는 위치에 저장됩니다.

반환 값

성공하면 메서드는 S_OK 반환하고 plDevErrVal이 가리키는 디바이스 오류 값을 지워야 합니다. 메서드가 실패하면 표준 COM 오류 코드를 반환하고 plDevErrVal이 가리키는 메모리에 미니 드라이버 관련 오류 코드 값을 배치해야 합니다. plDevErrVal이 가리키는 값은 IWiaMiniDrv::d rvGetDeviceErrorStr를 호출하여 문자열로 변환할 수 있습니다.

설명

드라이버 항목을 삭제하기 위해 WIA 서비스는 minidriver 메서드 IWiaMiniDrv::d rvDeleteItem을 호출합니다. 이 메서드에서 미니 드라이버는 WIA 서비스 컨텍스트 매개 변수 pWiasContext가 가리키는 항목을 삭제하려고 시도합니다. 항목이 성공적으로 삭제되면 메서드는 S_OK 반환하고 디바이스 오류 값 매개 변수 plDevErrVal 을 0으로 설정합니다. 디바이스 오류가 발생하면 메서드는 디바이스 오류 값 매개 변수 plDevErrVal에서 E_FAIL 및 디바이스별 오류 값을 반환합니다.

WIA 서비스가 이 메서드를 호출하기 전에 다음을 확인합니다.

  • 항목이 루트 항목이 아닙니다.

  • 항목이 폴더인 경우 자식이 없습니다.

  • 항목의 액세스 권한은 삭제를 허용합니다.

WIA 서비스는 이러한 조건을 확인하므로 미니드라이버에서도 확인할 필요가 없습니다.

요구 사항

요구 사항
대상 플랫폼 데스크톱
머리글 wiamindr_lh.h(Wiamindr.h 포함)

추가 정보

IWiaMiniDrv

IWiaMiniDrv::d rvGetDeviceErrorStr