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

IWiaItem::CreateChildItem 메서드는 애플리케이션에서 디바이스의 IWiaItem 트리에 IWiaItem 개체를 추가하는 데 사용됩니다.

구문

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

매개 변수

[in] lFlags

형식: LONG

WIA 항목 유형을 지정합니다. WIA 항목 유형 플래그에 나열된 값 중 하나로 설정해야 합니다.

[in] bstrItemName

형식: BSTR

WIA 항목 이름(예: "Top")을 지정합니다. 이 매개 변수는 파일 이름과 동일하다고 생각할 수 있습니다.

[in] bstrFullItemName

형식: BSTR

전체 WIA 항목 이름을 지정합니다. 이 매개 변수는 파일의 전체 경로(예: "003\Root\Top")와 동일하다고 생각할 수 있습니다.

[out] ppIWiaItem

형식: IWiaItem**

IWiaItem::CreateChildItem 메서드를 설정하는 IWiaItem 인터페이스에 대한 포인터의 주소를 받습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

일부 WIA 하드웨어 디바이스를 사용하면 애플리케이션이 디바이스를 나타내는 IWiaItem 트리에 새 항목을 만들 수 있습니다. 애플리케이션은 디바이스를 테스트하여 이 기능을 지원하는지 확인해야 합니다. IEnumWIA_DEV_CAPS 인터페이스를 사용하여 현재 디바이스의 기능을 열거합니다.

디바이스에서 IWiaItem 트리에서 새 항목을 만들 수 있는 경우 IWiaItem::CreateChildItem 을 호출하면 현재 노드의 자식인 새 IWiaItem 이 만들어집니다. IWiaItem::CreateChildItem 은 ppIWiaItem 매개 변수를 통해 새 노드에 대한 포인터를 애플리케이션에 전달합니다.

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

요구 사항