IWiaItem2::CreateChildItem-Methode

Artikel
06/13/2023

Erstellen Sie ein neues untergeordnetes Element. Fügt der IWiaItem2-Struktur eines Geräts IWiaItem2-Objekte hinzu.

Syntax

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

Parameter

lItemFlags [in]

Typ: LONG

Gibt den WIA 2.0-Elementtyp an. Weitere Informationen finden Sie unter WIA-Elementtypflags.

lCreationFlags [in]

Typ: LONG

Gibt an, wie das neue Element erstellt wird.

0 (0)

Legen Sie die Standardwerte für die Eigenschaften des untergeordneten Elements fest.

COPY_PARENT_PROPERTY_VALUES (0x40000000)

Kopieren Sie die Werte aller Lese-/Schreibeigenschaften aus dem übergeordneten Element.

bstrItemName [in]

Typ: BSTR

Gibt den Elementnamen an. Dieser Name wird am Ende des Namens des übergeordneten Elements angefügt, um den vollständigen Elementnamen zu generieren.

ppIWiaItem2 [out]

Typ: IWiaItem2**

Empfängt die Adresse eines Zeigers auf die IWiaItem2-Schnittstelle , die die IWiaItem2::CreateChildItem-Methode festlegt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Einige WIA 2.0-Hardwaregeräte ermöglichen Es Anwendungen, neue Elemente in der IWiaItem2-Struktur zu erstellen, die das Gerät darstellt. Anwendungen müssen die Geräte testen, um festzustellen, ob sie diese Funktion unterstützen. Verwenden Sie die IEnumWIA_DEV_CAPS-Schnittstelle, um die Funktionen des aktuellen Geräts aufzulisten.

Wenn das Gerät die Erstellung neuer Elemente in der IWiaItem2-Struktur zulässt, wird beim Aufrufen von IWiaItem2::CreateChildItem ein neues IWiaItem2-Objekt erstellt, das ein untergeordnetes Element des aktuellen Knotens ist. Er übergibt einen Zeiger auf den neuen Knoten über den ppIWiaItem2-Parameter an die Anwendung. Anwendungen müssen die IUnknown::Release-Methode für die Schnittstellenzeiger aufrufen, die sie über den ppIWiaItem2-Parameter erhalten.

Wenn lCreationFlags COPY_PARENT_PROPERTY_VALUES und lItemFlags null ist, gibt die Funktion E_INVALIDARG zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Wia.h
IDL	Wia.idl

Freigeben über