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錯誤， (Microsoft Windows SDK 檔) 中所述。
備註
當 minidriver 已完成使用它從這個函式收到的字串時，它必須解除分配用於字串的記憶體。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Microsoft Windows Me 和 Windows XP 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | 桌面 |
| 標頭 | wiamdef.h (包含Wiamdef.h) |
| 程式庫 | Wiaservc.lib |
| Dll | Wiaservc.dll |