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 |