Metodo IWiaItem2::CreateChildItem
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 |
|
| IDL |
|