IDiscRecorder::SetRecorderProperties 方法 (imapi.h)

接受对象的 IPropertyStorage 指针,其中包含应用程序希望更改的所有属性。 支持稀疏设置。 但是,建议使用 GetRecorderProperties 查询属性集,仅修改感兴趣的设置,然后调用 SetRecorderProperties 以同时更改所有值。

语法

HRESULT SetRecorderProperties(
  [in] IPropertyStorage *pPropStg
);

parameters

[in] pPropStg

指向 IPropertyStorage 接口的指针,光盘记录器可以使用该接口检索各种属性上的新设置。

返回值

S_OK成功后返回,但其他成功代码可能由于实现而返回。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:

注解

某些属性是只读的,例如 MaxWriteSpeed。 将忽略只读属性和不支持的属性,而不会生成错误 (看到IMAPI_S_PROPERTIESIGNORED) 。 例如,有人可以将属性集提交到此接口,并尝试更改 MaxWriteSpeed 和 ClearlyNeverHeardOfBefore 属性。 由于 MaxWriteSpeed 是只读的,并且 ClearlyNeverHeardOfBefore 是未知值,因此忽略这两个属性,并且该方法成功。

调用 SetRecorderProperties 后,应用程序应通过调用 GetRecorderProperties 来验证属性设置。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi.h
Library Uuid.lib
DLL Actxprxy.dll

另请参阅

IDiscRecorder