Método IWiaItem2::CreateChildItem

Cree un nuevo elemento secundario. Agrega objetos IWiaItem2 al árbol IWiaItem2 de un dispositivo.

Sintaxis

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

Parámetros

lItemFlags [in]

Tipo: LONG

Especifica el tipo de elemento WIA 2.0. Consulta Marcas de tipo de elemento WIA.

lCreationFlags [in]

Tipo: LONG

Especifica cómo crear el nuevo elemento.

0 (0)

Establezca los valores predeterminados para las propiedades del elemento secundario.

COPY_PARENT_PROPERTY_VALUES (0x40000000)

Copie los valores de todas las propiedades de lectura y escritura del elemento primario.

bstrItemName [in]

Tipo: BSTR

Especifica el nombre del elemento. Este nombre se anexa al final del nombre del elemento primario para generar el nombre completo del elemento.

ppIWiaItem2 [out]

Tipo: IWiaItem2**

Recibe la dirección de un puntero a la interfaz IWiaItem2 que establece el método IWiaItem2::CreateChildItem .

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

Algunos dispositivos de hardware WIA 2.0 permiten a las aplicaciones crear nuevos elementos en el árbol IWiaItem2 que representa el dispositivo. Las aplicaciones deben probar los dispositivos para ver si admiten esta funcionalidad. Use la interfaz IEnumWIA_DEV_CAPS para enumerar las funcionalidades del dispositivo actual.

Si el dispositivo permite la creación de nuevos elementos en el árbol IWiaItem2 , al invocar IWiaItem2::CreateChildItem se crea un nuevo objeto IWiaItem2 que es un elemento secundario del nodo actual. Pasa un puntero al nuevo nodo a la aplicación a través del parámetro ppIWiaItem2 . Las aplicaciones deben llamar al método IUnknown::Release en los punteros de interfaz que reciben a través del parámetro ppIWiaItem2 .

Si lCreationFlags es COPY_PARENT_PROPERTY_VALUES y lItemFlags es cero, la función devuelve E_INVALIDARG.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Wia.h
IDL	Wia.idl