IDiscFormat2Data::p ut_ClientName 方法 (imapi2.h)

设置客户端的友好名称。

语法

HRESULT put_ClientName(
  [in] BSTR value
);

参数

[in] value

客户端应用程序的名称。 不能为 NULL 或空字符串。

返回值

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

返回代码 说明
E_OUTOFMEMORY
未能分配所需的内存。

值:0x8007000E

E_IMAPI_DF2DATA_CLIENT_NAME_IS_NOT_VALID
客户端名称无效。

值:0xC0AA0211

E_IMAPI_DF2DATA_WRITE_IN_PROGRESS
当前正在进行写入操作。

值:0xC0AA0500

注解

当写入操作请求对设备的独占访问权限时,将使用该名称。 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

另请参阅

IDiscFormat2Data

IDiscFormat2Data::get_ClientName