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 la función se ejecuta correctamente, 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 WIA.
Observaciones
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 el minidriver crea y nombres.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | wiamdef.h (incluya Wiamdef.h) |
| biblioteca de | Wiaservc.lib |
| DLL de | Wiaservc.dll |