피드백

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

  • 아티클
  • 읽는 데 2분 걸림

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

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

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

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

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

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

요구 사항

   
대상 플랫폼 데스크톱
헤더 wiamindr_lh.h(Wiamindr.h 포함)

참고 항목

IWiaMiniDrv

IWiaMiniDrv::d rvGetDeviceErrorStr