IDiscFormat2Erase：:p ut_ClientName 方法 (imapi2.h)
设置客户端的友好名称。
语法
HRESULT put_ClientName(
[in] BSTR value
);
parameters
[in] value
客户端应用程序的名称。
返回值
成功后返回S_OK，但实现后可能会返回其他成功代码。 以下错误代码通常在操作失败时返回，但不表示唯一可能的错误值：
| 返回代码 | 说明 |
|---|---|
|
未能分配所需的内存。
值：0x8007000E |
|
一个或多个参数无效。
值：0x80070057 |
注解
当写入操作请求以独占方式访问设备时，将使用名称。 IDiscRecorder2：：get_ExclusiveAccessOwner 属性包含具有锁的客户端的名称。
由于在擦除操作期间对 CDROM 设备具有读/写访问权限的任何应用程序都可以使用IOCTL_CDROM_EXCLUSIVE_ACCESS (查询) 控制代码 (查看 Microsoft Windows 驱动程序开发工具包 (DDK) ) 来访问名称，因此名称必须标识使用此接口擦除到媒体的程序。 名称限制为与IOCTL_CDROM_EXCLUSIVE_ACCESS控制代码要求相同的字符集。
要求
| 最低受支持的客户端 | Windows Vista、Windows XP SP2 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | imapi2.h |