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

Consulte también

wiasGetRootItem