Поделиться через


функция wiasReadPropStr (wiamdef.h)

Функция wiasReadPropStr извлекает строковое значение свойства из элемента WIA.

Синтаксис

HRESULT wiasReadPropStr(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           BSTR   *pbstr,
  [out, optional] BSTR   *pbstrOld,
                  BOOL   bMustExist
);

Параметры

[in] pWiasContext

Указатель на контекст элемента WIA.

propid

Указывает идентификатор свойства.

[out] pbstr

Указатель на расположение памяти, которое получает первый байт строкового значения свойства.

[out, optional] pbstrOld

Указатель на расположение памяти, которое получает первый байт предыдущего значения свойства. Если эти сведения не нужны, задайте для этого параметра значение NULL.

bMustExist

Указывает, должно ли существовать свойство. Если задано значение TRUE, свойство должно существовать; Если задано значение FALSE, свойство не обязательно существует.

Возвращаемое значение

При успешном выполнении функция возвращает S_OK. Если функция завершается ошибкой, она возвращает стандартную ошибку COM или одну из WIA_ERROR_XXX ошибок (описанную в документации по пакету SDK для Microsoft Windows).

Замечания

После завершения мини-driver с помощью строки, полученной из этой функции, она должна освободить память, используемую для строки.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно в Microsoft Windows Me и Windows XP и более поздних версиях операционных систем Windows.
целевая платформа Настольный
заголовка wiamdef.h (включая Wiamdef.h)
библиотеки Wiaservc.lib
DLL Wiaservc.dll

См. также

wiasReadPropBin

wiasReadPropFloat

wiasReadPropGuid

wiasReadPropLong

wiasWritePropStr