wiasGetContextFromName 函数 (wiamdef.h)

wiasGetContextFromName 函数检索项名称的项上下文。

语法

HRESULT wiasGetContextFromName(
  [in]  BYTE *pWiasContext,
        LONG lFlags,
  [in]  BSTR bstrName,
  [out] BYTE **ppWiasContext
);

[in] pWiasContext

指向 WIA 项上下文的指针。

lFlags

保留供系统使用，应设置为 0。

[in] bstrName

指定要搜索的上下文的名称。

[out] ppWiasContext

指向接收 WIA 项上下文地址的内存位置的指针。

成功后，函数返回S_OK。

如果函数失败，它将返回标准 COM 错误或 WIA 错误代码之一。

此函数搜索其WIA_IPA_FULL_ITEM_NAME属性与 bstrName 匹配的项上下文。请注意，此属性不同于不包含路径信息的 WIA_IPA_ITEM_NAME。

当微型驱动程序需要从一个应用程序项上下文移动到另一个应用程序项上下文（给定项的名称）时，应使用此函数。应用程序项的名称来自其相应的驱动程序项，微型驱动程序会创建这些项和名称。