Metodo IWiaItem::CreateChildItem (wia_xp.h)

Il metodo IWiaItem::CreateChildItem viene usato dalle applicazioni per aggiungere oggetti IWiaItem all'albero IWiaItem di un dispositivo.

Sintassi

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

Parametri

[in] lFlags

Tipo: LONG

Specifica il tipo di elemento WIA. Deve essere impostato su uno dei valori elencati in Flag di tipo elemento WIA.

[in] bstrItemName

Tipo: BSTR

Specifica il nome dell'elemento WIA, ad esempio "Top". È possibile pensare a questo parametro come equivalente a un nome file.

[in] bstrFullItemName

Tipo: BSTR

Specifica il nome completo dell'elemento WIA. È possibile pensare a questo parametro come equivalente a un percorso completo di un file, ad esempio "003\Root\Top".

[out] ppIWiaItem

Tipo: IWiaItem**

Riceve l'indirizzo di un puntatore all'interfaccia IWiaItem che imposta il metodo IWiaItem::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 consentono alle applicazioni di creare nuovi elementi nell'albero IWiaItem 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 IWiaItem, richiamando IWiaItem::CreateChildItem crea un nuovo oggetto IWiaItem figlio del nodo corrente. IWiaItem::CreateChildItem passa un puntatore al nuovo nodo all'applicazione tramite il parametro ppIWiaItem .

Le applicazioni devono chiamare il metodo IUnknown::Release nei puntatori di interfaccia ricevuti tramite il parametro ppIWiaItem .

Requisiti