Función wiasGetContextFromName (wiamdef.h)
La función wiasGetContextFromName recupera el contexto del elemento para un nombre de elemento.
Sintaxis
HRESULT wiasGetContextFromName(
[in] BYTE *pWiasContext,
LONG lFlags,
[in] BSTR bstrName,
[out] BYTE **ppWiasContext
);
Parámetros
[in] pWiasContext
Puntero a un contexto de elemento WIA.
lFlags
Reservado para uso del sistema y debe establecerse en 0.
[in] bstrName
Especifica el nombre del contexto que se está buscando.
[out] ppWiasContext
Puntero a una ubicación de memoria que recibe la dirección del contexto del elemento WIA.
Valor devuelto
Si se ejecuta correctamente, la función devuelve S_OK.
Si se produce un error en la función, devuelve un error COM estándar o uno de los códigos de error de WIA.
Comentarios
Esta función busca contextos de elemento cuya propiedad WIA_IPA_FULL_ITEM_NAME coincide con bstrName. Tenga en cuenta que esta propiedad es diferente de WIA_IPA_ITEM_NAME, que no contiene información de ruta de acceso.
Los minidrivers deben usar esta función cuando necesiten pasar de un contexto de elemento de aplicación a otro, dado el nombre del elemento. Los nombres de los elementos de la aplicación proceden de sus elementos de controlador correspondientes, que crea el minidriver y los nombres.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | wiamdef.h (incluya Wiamdef.h) |
| Library | Wiaservc.lib |
| Archivo DLL | Wiaservc.dll |