wiasGetChildrenContexts-Funktion (wiamdef.h)

Die wiasGetChildrenContexts-Funktion ruft ein Array von Elementkontexten ab, die zu den untergeordneten Elementen des aktuellen Elements gehören.

Syntax

HRESULT wiasGetChildrenContexts(
  [in]  BYTE  *pParentContext,
  [out] ULONG *pulNumChildren,
  [out] BYTE  ***pppChildren
);

Parameter

[in] pParentContext

Zeiger auf das übergeordnete Element.

[out] pulNumChildren

Zeiger auf einen Speicherspeicherort, der die Anzahl der untergeordneten Kontexte empfängt.

[out] pppChildren

Zeiger auf einen Speicherspeicherort, der auf ein Array verweist, dessen Elemente Adressen von IWiaItem-Objekten sind. Jedes IWiaItem-Objekt stellt einen untergeordneten Kontext dar.

Rückgabewert

Bei Erfolg gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen COM-Standardfehler oder einen der WIA-Fehlercodes zurück.

Anforderungen