Metodo IWiaItem2::CreateChildItem

Articolo
06/13/2023

Creare un nuovo elemento figlio. Aggiunge oggetti IWiaItem2 all'albero IWiaItem2 di un dispositivo.

Sintassi

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

Parametri

lItemFlags [in]

Tipo: LONG

Specifica il tipo di elemento WIA 2.0. Vedere Flag di tipo di elemento WIA.

lCreationFlags [in]

Tipo: LONG

Specifica come creare il nuovo elemento.

0 (0 )

Impostare i valori predefiniti per le proprietà del figlio.

COPY_PARENT_PROPERTY_VALUES (0x40000000 )

Copiare i valori di tutte le proprietà di lettura/scrittura dall'elemento padre.

bstrItemName [in]

Tipo: BSTR

Specifica il nome dell'elemento. Questo nome viene aggiunto alla fine del nome dell'elemento padre per generare il nome completo dell'elemento.

ppIWiaItem2 [out]

Tipo: IWiaItem2**

Riceve l'indirizzo di un puntatore all'interfaccia IWiaItem2 che imposta il metodo IWiaItem2::CreateChildItem .

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Alcuni dispositivi hardware WIA 2.0 consentono alle applicazioni di creare nuovi elementi nell'albero IWiaItem2 che rappresenta il dispositivo. Le applicazioni devono testare i dispositivi per verificare se supportano questa funzionalità. Usare l'interfaccia IEnumWIA_DEV_CAPS per enumerare le funzionalità del dispositivo corrente.

Se il dispositivo consente la creazione di nuovi elementi nell'albero IWiaItem2, richiamando IWiaItem2::CreateChildItem crea un nuovo oggetto IWiaItem2 figlio del nodo corrente. Passa un puntatore al nuovo nodo all'applicazione tramite il parametro ppIWiaItem2 . Le applicazioni devono chiamare il metodo IUnknown::Release nei puntatori di interfaccia ricevuti tramite il parametro ppIWiaItem2 .

Se lCreationFlags è COPY_PARENT_PROPERTY_VALUES e lItemFlags è zero, la funzione restituisce E_INVALIDARG.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Wia.h
IDL	Wia.idl

Condividi tramite