IWiaItem::CreateChildItem-Methode (wia_xp.h)

Artikel
03/03/2024

Die IWiaItem::CreateChildItem-Methode wird von Anwendungen verwendet, um der IWiaItem-Struktur eines Geräts IWiaItem-Objekte hinzuzufügen.

Syntax

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

Parameter

[in] lFlags

Typ: LONG

Gibt den WIA-Elementtyp an. Muss auf einen der Werte festgelegt werden, die unter WIA-Elementtypflags aufgeführt sind.

[in] bstrItemName

Typ: BSTR

Gibt den WIA-Elementnamen an, z. B. "Top". Sie können sich vorstellen, dass dieser Parameter einem Dateinamen entspricht.

[in] bstrFullItemName

Typ: BSTR

Gibt den vollständigen WIA-Elementnamen an. Sie können sich diesen Parameter als gleichwertig mit einem vollständigen Pfad zu einer Datei vorstellen, z. B. "003\Root\Top".

[out] ppIWiaItem

Typ: IWiaItem**

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

Rückgabewert

Typ: HRESULT

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

Hinweise

Einige WIA-Hardwaregeräte ermöglichen Es Anwendungen, neue Elemente in der IWiaItem-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 IWiaItem-Struktur zulässt, wird durch aufrufen von IWiaItem::CreateChildItem ein neues IWiaItem erstellt, das ein untergeordnetes Element des aktuellen Knotens ist. IWiaItem::CreateChildItem übergibt einen Zeiger auf den neuen Knoten über den ppIWiaItem-Parameter an die Anwendung.

Anwendungen müssen die IUnknown::Release-Methode für die Schnittstellenzeiger aufrufen, die sie über den ppIWiaItem-Parameter empfangen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wia_xp.h (wia.h einschließen)
Bibliothek	Wiaguid.lib
DLL	Wiaservc.dll

Share via