wiasGetContextFromName-Funktion (wiamdef.h)
Die wiasGetContextFromName Funktion ruft den Elementkontext für einen Elementnamen ab.
Syntax
HRESULT wiasGetContextFromName(
[in] BYTE *pWiasContext,
LONG lFlags,
[in] BSTR bstrName,
[out] BYTE **ppWiasContext
);
Parameter
[in] pWiasContext
Zeiger auf einen WIA-Elementkontext.
lFlags
Reserviert für die Systemverwendung und sollte auf 0 festgelegt werden.
[in] bstrName
Gibt den Namen des Kontexts an, nach dem gesucht wird.
[out] ppWiasContext
Zeigen Sie auf einen Speicherspeicherort, der die Adresse des WIA-Elementkontexts empfängt.
Rückgabewert
Bei Erfolg gibt die Funktion S_OK zurück.
Wenn die Funktion fehlschlägt, wird ein STANDARDMÄßIGer COM-Fehler oder eine der WIA-Fehlercodeszurückgegeben.
Bemerkungen
Diese Funktion sucht nach Elementkontexten, deren WIA_IPA_FULL_ITEM_NAME Eigenschaft bstrName-entspricht. Beachten Sie, dass sich diese Eigenschaft von WIA_IPA_ITEM_NAME unterscheidet, die keine Pfadinformationen enthält.
Diese Funktion sollte von Minidrivern verwendet werden, wenn sie aufgrund des Namens des Elements von einem Anwendungselementkontext zu einem anderen wechseln müssen. Die Namen der Anwendungselemente stammen aus den entsprechenden Treiberelementen, die der Minidriver erstellt und namen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | wiamdef.h (include Wiamdef.h) |
| Library | Wiaservc.lib |
| DLL- | Wiaservc.dll |