다음을 통해 공유


IWiaDrvItem::FindItemByName 메서드(wiamindr_lh.h)

IWiaDrvItem::FindItemByName 메서드는 드라이버 항목 트리에서 항목의 전체 이름으로 항목을 찾습니다.

구문

HRESULT FindItemByName(
  LONG        __MIDL__IWiaDrvItem0007,
  BSTR        __MIDL__IWiaDrvItem0008,
  IWiaDrvItem **__MIDL__IWiaDrvItem0009
);

매개 변수

__MIDL__IWiaDrvItem0007

bstrFullItemName [in]

찾을 항목의 전체 이름을 지정합니다.

__MIDL__IWiaDrvItem0008

lFlags [in]

예약되어 있습니다. 0으로 설정됩니다.

__MIDL__IWiaDrvItem0009

ppItem [out, optional]

찾은 IWiaDrvItem 항목의 주소를 받을 메모리 위치를 가리킵니다.

반환 값

메서드가 성공하면 ppItem 에 찾은 항목에 대한 포인터를 저장하고 S_OK 반환합니다. 메서드가 실패하면 NULLppItem 에 배치하고 S_FALSE 반환합니다. 이 메서드가 필요한 항목을 찾지 못하면 S_FALSE 반환합니다. 검색 중에 오류가 발생하면 표준 COM 오류 코드가 반환됩니다.

설명

미니드라이버가 이 메서드를 호출하여 항목의 전체 이름이 알려지면 드라이버 항목 트리에서 항목을 찾습니다. 항목의 전체 이름은 IWiaDrvItem::GetFullItemName 메서드에서 가져옵니다.

이 메서드는 드라이버 항목 트리의 루트 항목에서 지정된 항목에 대한 검색을 시작합니다.

요구 사항

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

추가 정보

IWiaDrvItem

IWiaDrvItem::FindChildItemByName

IWiaDrvItem::GetFullItemName