IWiaItem::FindItemByName 메서드(wia_xp.h)

IWiaItem::FindItemByName 메서드는 이름을 검색 키로 사용하여 항목의 하위 항목 트리를 검색합니다. 각 IWiaItem 개체에는 표준 속성 중 하나로 이름이 있습니다.

구문

HRESULT FindItemByName(
  [in]  LONG     lFlags,
  [in]  BSTR     bstrFullItemName,
  [out] IWiaItem **ppIWiaItem
);

매개 변수

[in] lFlags

형식: LONG

현재 사용되지 않습니다. 0으로 설정해야 합니다.

[in] bstrFullItemName

형식: BSTR

검색할 항목의 이름을 지정합니다.

[out] ppIWiaItem

형식: IWiaItem**

IWiaItem 인터페이스에 대한 포인터입니다.

반환 값

형식: HRESULT

이 메서드는 항목을 찾으면 S_OK 반환하거나 항목을 찾을 수 없는 경우 S_FALSE. 메서드가 실패하면 표준 COM 오류 코드를 반환합니다.

설명

이 메서드는 이름을 검색 키로 사용하여 하위 항목의 현재 항목 트리를 검색합니다. IWiaItem::FindItemByName이 bstrFullItemName으로 지정된 항목을 찾으면 항목의 IWiaItem 인터페이스에 대한 포인터의 주소를 ppIWiaItem 매개 변수에 저장합니다.

애플리케이션은 ppIWiaItem 매개 변수를 통해 수신하는 인터페이스 포인터에서 IUnknown::Release 메서드를 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wia_xp.h(Wia.h 포함)
라이브러리	Wiaguid.lib
DLL	Wiaservc.dll