IPhotoProgressDialog::GetUserInput 方法 (photoacquire.h)

检索用户输入的描述性信息,例如要存储的图像的标记名称。

语法

HRESULT GetUserInput(
  [in]  REFIID            riidType,
  [in]  IUnknown          *pUnknown,
  [out] PROPVARIANT       *pPropVarResult,
  [in]  const PROPVARIANT *pPropVarDefault
);

参数

[in] riidType

指定提示类型的接口标识符 (ID) 。 目前,唯一支持的值是IID_IUserInputString。

[in] pUnknown

指向 prompt 类的 对象的指针。 目前,唯一支持的类型是 IUserInputString

[out] pPropVarResult

指向存储用户输入的属性变体的指针。 调用方必须使用 ClearPropVariant 释放。

[in] pPropVarDefault

指向属性变体的指针,其中包含未提供任何输入时要使用的默认值。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。
S_FALSE
进度对话框已被禁止

注解

如果在 IPhotoAcquire::Acquire 中禁止显示进度对话框,并且 IPhotoAcquireProgressCB::GetUserInput 未实现或返回E_NOTIMPL,则此方法将返回S_FALSE,并且 pPropVarResult 将包含存储在可选 pPropVarDefault 参数中的值。

要求

要求
目标平台 Windows
标头 photoacquire.h
Library PhotoAcquireUID.lib

另请参阅

IPhotoAcquireProgressCB 接口

IPhotoProgressDialog 接口