Función wiasReadPropStr (wiamdef.h)
La función wiasReadPropStr recupera un valor de propiedad de cadena de un elemento WIA.
Sintaxis
HRESULT wiasReadPropStr(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BSTR *pbstr,
[out, optional] BSTR *pbstrOld,
BOOL bMustExist
);
Parámetros
[in] pWiasContext
Puntero a un contexto de elemento WIA.
propid
Especifica el identificador de propiedad.
[out] pbstr
Puntero a una ubicación de memoria que recibe el primer byte del valor de cadena de la propiedad.
[out, optional] pbstrOld
Puntero a una ubicación de memoria que recibe el primer byte del valor anterior de la propiedad. Si esta información no es necesaria, establezca este parámetro en NULL.
bMustExist
Indica si la propiedad debe existir. Si se establece en TRUE, la propiedad debe existir; si se establece en FALSE, la propiedad no tiene que existir.
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 errores de WIA_ERROR_XXX (descritos en la documentación de Microsoft Windows SDK).
Comentarios
Cuando el minidriver se haya completado con la cadena que recibió de esta función, debe desasignar la memoria utilizada para la cadena.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows Me y en Windows XP y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | wiamdef.h (incluya Wiamdef.h) |
| Library | Wiaservc.lib |
| Archivo DLL | Wiaservc.dll |