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
Zeiger auf einen Speicherort, der die Adresse des WIA-Elementkontexts empfängt.
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.
Hinweise
Diese Funktion sucht nach Elementkontexten, deren WIA_IPA_FULL_ITEM_NAME -Eigenschaft mit bstrName übereinstimmt. 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 unter Berücksichtigung des Namens des Elements von einem Anwendungselementkontext zu einem anderen wechseln müssen. Die Namen der Anwendungselemente stammen aus den entsprechenden Treiberelementen, die der Minitreiber erstellt, und den Namen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamdef.h (wiamdef.h einschließen) |
| Bibliothek | Wiaservc.lib |
| DLL | Wiaservc.dll |