wiasReadPropBin 函式 (wiamdef.h)
wiasReadPropBin 函式會從 WIA 專案擷取二進位數據屬性值。
語法
HRESULT wiasReadPropBin(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BYTE **ppbVal,
[out, optional] BYTE **ppbValOld,
BOOL bMustExist
);
參數
[in] pWiasContext
WIA 專案內容的指標。
propid
指定屬性識別碼。
[out] ppbVal
接收這個函式所配置之緩衝區位址的記憶體位置指標。 傳回時，緩衝區會包含屬性的二進位數據。
[out, optional] ppbValOld
接收迷你驅動程式所配置之緩衝區位址的記憶體位置指標。 傳回時，緩衝區會包含屬性二進位數據的先前值。 如果不需要此資訊，此參數可以設定為 NULL。
bMustExist
指出屬性是否必須存在。 如果設定為 TRUE，屬性必須存在;如果設定為 FALSE，則屬性不需要存在。
傳回值
成功時，函式會傳回S_OK。
如果函式失敗，它會傳回標準 COM 錯誤或其中一個 WIA 錯誤碼。
備註
此函式會配置緩衝區，並將其位址儲存在 ppbVal 參數中。 迷你驅動程序必須呼叫 CoTaskMemFree 來釋放緩衝區。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | wiamdef.h (包含Wiamdef.h) |
| 程式庫 | Wiaservc.lib |
| Dll | Wiaservc.dll |