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