IWiaItem2::CreateChildItem 메서드

새 자식 항목을 만듭니다. 디바이스의 IWiaItem2 트리에 IWiaItem2 개체를 추가합니다.

구문

HRESULT CreateChildItem(
  [in]  LONG      lItemFlags,
  [in]  LONG      lCreationFlags,
  [in]  BSTR      bstrItemName,
  [out] IWiaItem2 **ppIWiaItem2
);

매개 변수

lItemFlags [in]

형식: LONG

WIA 2.0 항목 유형을 지정합니다. WIA 항목 유형 플래그를 참조하세요.

lCreationFlags [in]

형식: LONG

새 항목을 만드는 방법을 지정합니다.

0 (0)

자식 속성의 기본값을 설정합니다.

COPY_PARENT_PROPERTY_VALUES (0x40000000)

부모에서 모든 읽기/쓰기 속성의 값을 복사합니다.

bstrItemName [in]

형식: BSTR

항목 이름을 지정합니다. 이 이름은 전체 항목 이름을 생성하기 위해 부모 항목 이름 끝에 추가됩니다.

ppIWiaItem2 [out]

형식: IWiaItem2**

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

반환 값

형식: HRESULT

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

설명

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

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

lCreationFlags가 COPY_PARENT_PROPERTY_VALUES lItemFlags가 0이면 함수는 E_INVALIDARG 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
헤더	Wia.h
IDL	Wia.idl