Método IWiaItem::CreateChildItem (wia_xp.h)

Las aplicaciones usan el método IWiaItem::CreateChildItem para agregar objetos IWiaItem al árbol IWiaItem de un dispositivo.

Sintaxis

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

Parámetros

[in] lFlags

Tipo: LONG

Especifica el tipo de elemento WIA. Debe establecerse en uno de los valores enumerados en marcas de tipo de elemento WIA.

[in] bstrItemName

Tipo: BSTR

Especifica el nombre del elemento WIA, como "Top". Puede considerar este parámetro como equivalente a un nombre de archivo.

[in] bstrFullItemName

Tipo: BSTR

Especifica el nombre completo del elemento WIA. Puede considerar este parámetro como equivalente a una ruta de acceso completa a un archivo, como "003\Root\Top".

[out] ppIWiaItem

Tipo: IWiaItem**

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

Valor devuelto

Tipo: HRESULT

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

Comentarios

Algunos dispositivos de hardware WIA permiten a las aplicaciones crear nuevos elementos en el árbol IWiaItem 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 IWiaItem , al invocar IWiaItem::CreateChildItem se crea un nuevo IWiaItem que es un elemento secundario del nodo actual. IWiaItem::CreateChildItem pasa un puntero al nuevo nodo a la aplicación a través del parámetro ppIWiaItem .

Las aplicaciones deben llamar al método IUnknown::Release en los punteros de interfaz que reciben a través del parámetro ppIWiaItem .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wia_xp.h (incluye Wia.h)
Library	Wiaguid.lib
Archivo DLL	Wiaservc.dll